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 回调函数：

  1. 当配置文件驱动程序充当服务器时，它会使用 的 IndicationCallback 成员注册 L2CAP 回调函数 _BRB_L2CA_REGISTER_SERVER 结构。 然后，当远程设备尝试联系配置文件驱动程序时，蓝牙驱动程序堆栈可以通知该驱动程序。
  2. 当配置文件驱动程序充当客户端并尝试使用 BRB_L2CA_OPEN_CHANNEL BRB 连接到远程设备时，配置文件驱动程序将使用在配置文件驱动程序生成并发送BRB_L2CA_OPEN_CHANNEL或 时传递的_BRB_L2CA_OPEN_CHANNEL结构的 Callback 成员注册其 L2CAP 回调函数 BRB_L2CA_OPEN_CHANNEL_RESPONSE 请求。
配置文件驱动程序注册其 L2CAP 回调函数后，回调函数仅与 BRB 打开的通道相关联。 蓝牙驱动程序堆栈可以调用 L2CAP 回调函数，以通知配置文件驱动程序通过打开通道向远程设备发生的操作。 配置文件驱动程序可以注册单个回调函数，以将通道通知作为客户端处理，将连接通知作为服务器进行处理。

参数中包含的INDICATION_PARAMETERS结构根据蓝牙驱动程序堆栈通过 Indication 参数传递给配置文件驱动程序的 L2CAP 回调函数的 INDICATION_CODE 枚举的值进行解释。 对于大多数通知，INDICATION_PARAMETERS联合成员对应于事件并包含特定于事件的参数。

要求

要求 值
最低受支持的客户端 版本：Windows Vista 及更高版本中_Supported。
目标平台 桌面
标头 bthddi.h (包括 Bthddi.h)
IRQL 如果回调函数无法访问分页内存) ，则开发人员应将此函数编码为在 IRQL = DISPATCH_LEVEL (下运行;如果回调函数必须访问分页) 内存，则 IRQL = PASSIVE_LEVEL (

另请参阅

INDICATION_CODE

INDICATION_PARAMETERS

_BRB_L2CA_OPEN_CHANNEL

_BRB_L2CA_REGISTER_SERVER