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

Статья
08/07/2023

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

Синтаксис

struct _BRB_SCO_REGISTER_SERVER {
  BRB_HEADER                 Hdr;
  BTH_ADDR                   BtAddress;
  ULONG                      Reserved;
  ULONG                      IndicationFlags;
  PFNSCO_INDICATION_CALLBACK IndicationCallback;
  PVOID                      IndicationCallbackContext;
  PVOID                      ReferenceObject;
  SCO_SERVER_HANDLE          ServerHandle;
};

Члены

Hdr

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

BtAddress

Адрес удаленного устройства Bluetooth, для которого будут получаться уведомления.

Reserved

Зарезервировано для последующего использования. Не используйте.

IndicationFlags

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

Пометить	Описание
SCO_INDICATION_SCO_REQUEST	Сообщите драйверу профиля о наличии каких-либо входящих подключений SCO.
SCO_INDICATION_ESCO_REQUEST	Сообщите драйверу профиля о наличии входящих подключений eSCO.

IndicationCallback

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

IndicationCallbackContext

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

ReferenceObject

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

ServerHandle

Дескриптор на сервере SCO, если он успешно возвращен. Когда драйвер профиля больше не должен получать признаки удаленного подключения, он должен передать этот дескриптор в BRB_SCO_UNREGISTER_SERVER.

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

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

Когда драйвер профиля получает уведомление о попытке подключения, он должен выполнить сборку и отправить BRB_SCO_OPEN_CHANNEL_RESPONSE запрос на принятие или отклонение попытки подключения. Дополнительные сведения о принятии или отклонении попыток подключения SCO см . в _BRB_SCO_OPEN_CHANNEL структуре.

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

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

Требования

Требование	Значение
Минимальная версия клиента	Versions:_Supported в Windows Vista и более поздних версий.
Верхняя часть	bthddi.h (включая Bthddi.h)