PFNBTHPORT_INDICATION_CALLBACK回调函数 (bthddi.h)
配置文件驱动程序实现 L2CAP 回调函数,以便为蓝牙驱动程序堆栈提供一种机制,以通知来自远程设备的传入 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 连接的更改,这是生成并发送 _BRB_L2CA_OPEN_CHANNEL BRB 时由配置文件驱动程序指定的 CallbackContext 成员。
[in] Indication
指示 L2CAP 事件的类型的 INDICATION_CODE 值。
[in] Parameters
包含特定于事件的参数的 INDICATION_PARAMETERS 结构。
返回值
没有
言论
配置文件驱动程序在以下两种情况下注册其 L2CAP 回调函数:
- 当配置文件驱动程序充当服务器时,它将使用 IndicationCallback 成员注册 L2CAP 回调函数 _BRB_L2CA_REGISTER_SERVER 结构。 然后,当远程设备尝试联系它时,蓝牙驱动程序堆栈可以通知配置文件驱动程序。
- 当配置文件驱动程序充当客户端并尝试使用 BRB_L2CA_OPEN_CHANNEL BRB 连接到远程设备时,配置文件 驱动程序使用 Callback 成员注册其 L2CAP 回调函数,该 _BRB_L2CA_OPEN_CHANNEL函数是在配置文件驱动程序生成并发送BRB_L2CA_OPEN_CHANNEL 或 BRB_L2CA_OPEN_CHANNEL_RESPONSE 请求。
根据蓝牙驱动程序堆栈通过 指示 参数传递给配置文件驱动程序 L2CAP 回调函数 INDICATION_CODE 枚举的值解释 参数中保存的 INDICATION_PARAMETERS 结构。 对于大多数通知,有一个与事件对应的INDICATION_PARAMETERS联合成员,其中包含特定于事件的参数。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows Vista 及更高版本中的版本:_Supported。 |
目标平台 | 桌面 |
标头 | bthddi.h (包括 Bthddi.h) |
IRQL | 开发人员应将此函数编码为在 IRQL = DISPATCH_LEVEL(如果回调函数无法访问分页内存),或者 IRQL = PASSIVE_LEVEL(如果回调函数必须访问分页内存) |