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

Статья
08/07/2023

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

Синтаксис

PFNBTHPORT_INDICATION_CALLBACK PfnbthportIndicationCallback;

void PfnbthportIndicationCallback(
  [in] PVOID Context,
  [in] INDICATION_CODE Indication,
  [in] PINDICATION_PARAMETERS Parameters
)
{...}

Параметры

[in] Context

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

[in] Indication

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

[in] Parameters

Структура INDICATION_PARAMETERS , содержащая параметры, относящиеся к событиям.

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

None

Remarks

Драйвер профиля регистрирует функцию обратного вызова L2CAP в следующих двух сценариях:

Когда драйвер профиля выступает в качестве сервера, он регистрирует функцию обратного вызова L2CAP с помощью элемента IndicationCallback _BRB_L2CA_REGISTER_SERVER структура. Затем стек драйверов Bluetooth может уведомлять драйвер профиля, когда удаленное устройство пытается связаться с ним.
Когда драйвер профиля выступает в качестве клиента и пытается подключиться к удаленному устройству с помощью BRB_L2CA_OPEN_CHANNEL BRB, драйвер профиля регистрирует свою функцию обратного вызова L2CAP с помощью элемента Callback структуры _BRB_L2CA_OPEN_CHANNEL, которая передается, когда драйвер профиля создает и отправляет BRB_L2CA_OPEN_CHANNEL или BRB_L2CA_OPEN_CHANNEL_RESPONSE запрос.

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

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

Требования

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

См. также раздел

INDICATION_CODE

INDICATION_PARAMETERS

_BRB_L2CA_OPEN_CHANNEL

_BRB_L2CA_REGISTER_SERVER

Поделиться через