функция обратного вызова PFNSCO_INDICATION_CALLBACK (bthddi.h)

Статья
08/07/2023

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

Синтаксис

PFNSCO_INDICATION_CALLBACK PfnscoIndicationCallback;

void PfnscoIndicationCallback(
  [in] PVOID Context,
  [in] SCO_INDICATION_CODE Indication,
  [in] PSCO_INDICATION_PARAMETERS Parameters
)
{...}

Параметры

[in] Context

Для указания входящих запросов удаленного подключения это контекст, заданный драйвером профиля в элементе IndicationCallbackContextструктуры _BRB_SCO_REGISTER_SERVER , когда драйвер профиля зарегистрировал функцию обратного вызова. Для изменений существующих подключений SCO это член CallbackContext , указанный драйвером профиля при сборке и отправке BRB_SCO_OPEN_CHANNEL BRB.

[in] Indication

Значение SCO_INDICATION_CODE , указывающее тип события SCO.

[in] Parameters

A SCO_INDICATION_PARAMETERS структура, содержащая сведения о параметрах на основе значения, переданного параметру Индикация .

Возвращаемое значение

None

Remarks

Элемент BtAddress, найденный в структуре SCO_INDICATION_PARAMETERS, переданной в параметре Parameters , указывает bluetooth-адрес удаленного устройства.

Функцию PFNSCO_INDICATION_CALLBACK можно зарегистрировать двумя способами.

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

Во втором случае драйвер профиля выступает в качестве клиента и пытается подключиться к удаленному устройству с помощью BRB_SCO_OPEN_CHANNEL BRB. Функция обратного вызова PFNSCO_INDICATION_CALLBACK регистрируется через член обратного вызова структуры _BRB_SCO_OPEN_CHANNEL , передаваемой с указанным BRB, при отправке одного из них через IOCTL_INTERNAL_BTH_SUBMIT_BRB.

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

Структура SCO_INDICATION_PARAMETERS, хранящееся в параметре Parameters , интерпретируется в соответствии с SCO_INDICATION_CODE значением, которое передается функции обратного вызова через параметр Индикация . Для большинства уведомлений существует SCO_INDICATION_PARAMETERS член объединения, соответствующий событию и содержащий параметры, относящиеся к событию.

Требования

Требование	Значение
Минимальная версия клиента	Versions:_Supported в Windows Vista и более поздних версиях.
Целевая платформа	Персональный компьютер
Верхняя часть	bthddi.h (включая Bthddi.h)
IRQL	Разработчики должны закодировать эту функцию для работы в IRQL = DISPATCH_LEVEL (если функция обратного вызова не обращается к памяти с постраничной памятью) или IRQL = PASSIVE_LEVEL (если функция обратного вызова должна обращаться к памяти с разбавляемой памятью).