структура _BRB_L2CA_REGISTER_SERVER (bthddi.h)

Драйвер профиля использует структуру _BRB_L2CA_REGISTER_SERVER для регистрации себя в качестве сервера, способного получать подключения L2CAP с удаленных устройств Bluetooth.

Синтаксис

struct _BRB_L2CA_REGISTER_SERVER {
  BRB_HEADER                     Hdr;
  BTH_ADDR                       BtAddress;
  USHORT                         PSM;
  ULONG                          IndicationFlags;
  PFNBTHPORT_INDICATION_CALLBACK IndicationCallback;
  PVOID                          IndicationCallbackContext;
  PVOID                          ReferenceObject;
  OUT L2CAP_SERVER_HANDLE        ServerHandle;
};

Члены

Hdr

Структура BRB_HEADER, содержащая сведения о текущем BRB.

BtAddress

Адрес удаленного устройства Bluetooth для получения уведомлений. Укажите BTH_ADDR_NULL для получения уведомлений о входящих подключениях.

PSM

Мультиплексер протокола или службы ( PSM), принимаюющий запросы на подключение.

IndicationFlags

Необязательный флаг или сочетание флагов, указывающих, будет ли драйвер профиля принимать уведомления о связывании в дополнение к уведомлениям о подключении. В следующей таблице перечислены возможные параметры флага.

IndicationCallback

Функция обратного вызова L2CAP L2CAP, реализованная драйвером профиля, должна вызывать стек драйверов Bluetooth, чтобы уведомить драйвера профиля о входящих подключениях L2CAP.

IndicationCallbackContext

Контекст, передаваемый функции обратного вызова, указанной в элементе IndicationCallback.

ReferenceObject

Указатель на объект для передачи в ObReferenceObject и функции ObDereferenceObject для поддержания счетчика ссылок. Драйверы профилей должны предоставить этот объект таким образом, чтобы стек драйверов Bluetooth может увеличить количество объектов до тех пор, пока стек драйверов может вызвать функцию обратного вызова, указанную в элементе IndicationCallback. Стек драйверов Bluetooth уменьшит количество ссылок объекта, когда драйвер профиля сборки и отправляетзапрос BRB_L2CA_UNREGISTER_SERVER.

ServerHandle

При успешном возвращении дескриптор на сервер L2CAP. Если драйвер профиля больше не должен получать указания удаленного подключения, он должен передать этот дескриптор в BRB_L2CA_UNREGISTER_SERVER.

Замечания

Чтобы зарегистрировать себя в качестве сервера L2CAP, драйвер профиля должен сборки и отправкизапрос BRB_L2CA_REGISTER_SERVER.

После регистрации самого драйвера профиля он должен сборку и отправить запрос BRB_REGISTER_PSM, чтобы стек драйверов Bluetooth принял подключения из PSM.

В случае успешного выполнения стек драйверов Bluetooth может уведомить драйвер профиля при попытке удаленных устройств создать подключение L2CAP к драйверу профиля на определенном PSM.

Драйвер профиля может указать ноль psm член структуры _BRB_L2CA_REGISTER_SERVER, что означает, что PSM не указан, и драйвер профиля впоследствии выдает BRB_REGISTER_PSM BRB для получения динамической PSM для регистрации для уведомлений о подключении. Дополнительные сведения о PSMs см. в _BRB_PSM.

После регистрации драйвера профиля стек драйверов Bluetooth может уведомить его, когда удаленное устройство пытается подключиться к нему, вызвав функцию обратного вызова L2CAP, что драйвер профиля реализует и указывает в элементе IndicationCallback.

Дополнительные сведения о серверах L2CAP и PSMs см. в прием подключений L2CAP в драйвере профиля Bluetooth.

Когда драйвер профиля получает уведомление о попытке подключения, он должен сборки и отправки BRB_L2CA_OPEN_CHANNEL_RESPONSE BRB принять или отклонить попытку подключения. Дополнительные сведения о принятии или отклонении попыток подключения L2CAP см. в _BRB_L2CA_OPEN_CHANNEL структуре.

После установки подключения драйвер профиля может выдавать другие BRB для связи с удаленным устройством.

Чтобы остановить получение уведомлений об удаленном подключении, драйвер профиля должен сборку и отправитьзапрос BRB_L2CA_UNREGISTER_SERVER.

Хотя эта процедура позволяет драйверу профиля принимать входящие запросы на подключение, он не автоматически объявляет службу с помощью SDP. Чтобы объявить службу с помощью SDP, драйвер профиля должен отправить запись SDP с помощью API SDP. Дополнительные сведения о рекламных службах с SDP см. в связи с серверами SDP.

Требования

См. также

BRB_HEADER

BRB_L2CA_REGISTER_SERVER

BRB_L2CA_UNREGISTER_SERVER

функция обратного вызова L2CAP

ObDereferenceObject

ObReferenceObject