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

Статья
06.02.2025

Драйверы профилей реализуют функцию обратного вызова 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, содержащая параметры, относящиеся к событиям.

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

Никакой

Замечания

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

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

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

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

Требования

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