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 连接到远程设备时,配置文件驱动程序将使用在配置文件驱动程序生成并发送BRB_L2CA_OPEN_CHANNEL或 时传递的_BRB_L2CA_OPEN_CHANNEL结构的 Callback 成员注册其 L2CAP 回调函数 BRB_L2CA_OPEN_CHANNEL_RESPONSE 请求。
参数中包含的INDICATION_PARAMETERS结构根据蓝牙驱动程序堆栈通过 Indication 参数传递给配置文件驱动程序的 L2CAP 回调函数的 INDICATION_CODE 枚举的值进行解释。 对于大多数通知,INDICATION_PARAMETERS联合成员对应于事件并包含特定于事件的参数。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 版本:Windows Vista 及更高版本中_Supported。 |
目标平台 | 桌面 |
标头 | bthddi.h (包括 Bthddi.h) |
IRQL | 如果回调函数无法访问分页内存) ,则开发人员应将此函数编码为在 IRQL = DISPATCH_LEVEL (下运行;如果回调函数必须访问分页) 内存,则 IRQL = PASSIVE_LEVEL ( |