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 连接到远程设备时,配置文件 驱动程序使用 Callback 成员注册其 L2CAP 回调函数,该 _BRB_L2CA_OPEN_CHANNEL函数是在配置文件驱动程序生成并发送BRB_L2CA_OPEN_CHANNEL BRB_L2CA_OPEN_CHANNEL_RESPONSE 请求。
配置文件驱动程序注册其 L2CAP 回调函数后,回调函数仅与 BRB 打开的通道相关联。 蓝牙驱动程序堆栈可以调用 L2CAP 回调函数,以通知配置文件驱动程序通过打开通道向远程设备发生的作。 配置文件驱动程序可以注册单个回调函数,以将通道通知作为客户端处理,并将连接通知作为服务器进行处理。

根据蓝牙驱动程序堆栈通过 指示 参数传递给配置文件驱动程序 L2CAP 回调函数 INDICATION_CODE 枚举的值解释 参数中保存的 INDICATION_PARAMETERS 结构。 对于大多数通知,有一个与事件对应的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