INDICATION_PARAMETERS_ENHANCED 结构 (bthddi.h)

项目
02/26/2024

INDICATION_PARAMETERS_ENHANCED结构作为 Parameters 参数传递到配置文件驱动程序的增强型 L2CAP 回调函数

语法

typedef struct _INDICATION_PARAMETERS_ENHANCED {
  L2CAP_CHANNEL_HANDLE ConnectionHandle;
  IN BTH_ADDR          BtAddress;
  union {
    struct {
      struct {
        OUT USHORT PSM;
      } Request;
    } Connect;
    struct {
      CHANNEL_CONFIG_PARAMETERS_ENHANCED CurrentParams;
      CHANNEL_CONFIG_PARAMETERS_ENHANCED RequestedParams;
      CHANNEL_CONFIG_PARAMETERS_ENHANCED ResponseParams;
      USHORT                             Response;
    } ConfigRequest;
    struct {
      CHANNEL_CONFIG_PARAMETERS_ENHANCED CurrentParams;
      CHANNEL_CONFIG_PARAMETERS_ENHANCED RequestedParams;
      CHANNEL_CONFIG_PARAMETERS_ENHANCED RejectedParams;
      PCO_TYPE                           UnknownTypes;
      ULONG                              NumUnknownTypes;
      CHANNEL_CONFIG_PARAMETERS_ENHANCED NewRequestParams;
      USHORT                             Response;
    } ConfigResponse;
    struct {
      ULONG                NumExtraOptions;
      PL2CAP_CONFIG_OPTION ExtraOptions;
    } FreeExtraOptions;
    struct {
      L2CAP_DISCONNECT_REASON Reason;
      BOOLEAN                 CloseNow;
    } Disconnect;
    struct {
      ULONG PacketLength;
      ULONG TotalQueueLength;
    } RecvPacket;
    PVOID Reserved;
  } Parameters;
} *PINDICATION_PARAMETERS_ENHANCED, INDICATION_PARAMETERS_ENHANCED;

成员

ConnectionHandle

远程设备的 L2CAP 连接句柄。此句柄仅对通过已建立的 L2CAP 连接到达的通知有效。

BtAddress

远程设备的蓝牙地址。

Parameters

Parameters.Connect

包含 IndicationRemoteConnect 回调函数的参数的结构。

Parameters.Connect.Request

包含连接请求的参数的结构。

Parameters.Connect.Request.PSM

协议/服务多路复用器 (PSM) ，在增强型回调函数的 Indication 参数中指定 IndicationRemoteConnect INDICATION_CODE 值时，将传递给调用函数。

Parameters.ConfigRequest

包含 IndicationRemoteConfigRequest INDICATION_CODE 值的参数的结构。

Parameters.ConfigRequest.CurrentParams

包含当前通道参数的CHANNEL_CONFIG_PARAMETERS_ENHANCED 结构。仅当通道以前打开且现在处于配置过程中时，此值才有效。回调函数指定 IndicationRemoteConfigRequest INDICATION_CODE值时使用此成员。

Parameters.ConfigRequest.RequestedParams

一个CHANNEL_CONFIG_PARAMETERS_ENHANCED结构，其中包含从远程主机为配置请求传递的参数。回调函数指定 IndicationRemoteConfigRequest INDICATION_CODE值时使用此成员。

Parameters.ConfigRequest.ResponseParams

一个CHANNEL_CONFIG_PARAMETERS_ENHANCED结构，其中包含配置文件驱动程序用于响应配置请求的参数。

Parameters.ConfigRequest.Response

指示配置请求状态的标志。下表中列出了有效的标志值。

标志	描述
CONFIG_STATUS_SUCCESS	配置请求成功。
CONFIG_STATUS_DISCONNECT	配置请求失败，因为增强的 L2CAP 连接已断开连接。
CONFIG_STATUS_INVALID_PARAMETER	配置请求失败，因为向配置文件驱动程序传递了无效参数。
CONFIG_STATUS_REJECT	配置文件驱动程序拒绝了配置请求。
CONFIG_STATUS_UNKNOWN_OPTION	配置请求失败，因为配置文件驱动程序无法识别指定的配置选项之一。

Parameters.ConfigResponse

包含 IndicationRemoteConfigResponse INDICATION_CODE 值的参数的结构。

Parameters.ConfigResponse.CurrentParams

包含当前通道参数的CHANNEL_CONFIG_PARAMETERS_ENHANCED 结构。

仅当通道以前打开且现在处于配置过程中时，此值才有效。回调函数指定 IndicationRemoteConfigRequest INDICATION_CODE值时使用此成员。

Parameters.ConfigResponse.RequestedParams

一个CHANNEL_CONFIG_PARAMETERS_ENHANCED结构，其中包含从远程主机为配置请求传递的参数。回调函数指定 IndicationRemoteConfigRequest INDICATION_CODE值时使用此成员。

Parameters.ConfigResponse.RejectedParams

包含远程设备拒绝的配置参数设置的CHANNEL_CONFIG_PARAMETERS_ENHANCED结构。

Parameters.ConfigResponse.UnknownTypes

响应设备无法识别的类型数组。

Parameters.ConfigResponse.NumUnknownTypes

UnknownTypes 成员中无法识别的类型数。

Parameters.ConfigResponse.NewRequestParams

一个CHANNEL_CONFIG_PARAMETERS_ENHANCED结构，其中包含增强型回调函数的参数设置，以便在远程设备返回响应后重新提交。

Parameters.ConfigResponse.Response

指示配置请求状态的标志。下表中列出了有效的标志值：

标志	描述
CONFIG_STATUS_SUCCESS	配置请求成功。
CONFIG_STATUS_DISCONNECT	配置请求失败，因为增强的 L2CAP 连接已断开连接。
CONFIG_STATUS_INVALID_PARAMETER	配置请求失败，因为向配置文件驱动程序传递了无效参数。
CONFIG_STATUS_REJECT	配置文件驱动程序拒绝了配置请求。
CONFIG_STATUS_UNKNOWN_OPTION	配置请求失败，因为配置文件驱动程序无法识别指定的配置选项之一。

Parameters.FreeExtraOptions

包含 IndicationFreeExtraOptions INDICATION_CODE 值的参数的结构。

Parameters.FreeExtraOptions.NumExtraOptions

ExtraOptions 成员中包含的额外选项数。

Parameters.FreeExtraOptions.ExtraOptions

其他选项。

Parameters.Disconnect

包含 IndicationRemoteDisconnect INDICATION_CODE 值的参数的结构。

Parameters.Disconnect.Reason

一个L2CAP_DISCONNECT_REASON值，该值指示终止与远程设备的 L2CAP 连接的原因。

Parameters.Disconnect.CloseNow

配置文件驱动程序用于通知蓝牙驱动程序堆栈关闭 L2CAP 连接的布尔值。将此成员设置为 TRUE 以通知蓝牙驱动程序堆栈关闭连接。否则，将其设置为 FALSE 以保持连接打开状态。

Parameters.RecvPacket

包含 IndicationRecvPacket INDICATION_CODE 值的参数的结构。

Parameters.RecvPacket.PacketLength

回调函数通过 L2CAP 连接发送的数据包的大小（以字节为单位）。

Parameters.RecvPacket.TotalQueueLength

要通过 L2CAP 连接处理的数据包数。

Parameters.Reserved

保留成员。请勿使用。

要求

要求	值
最低受支持的客户端	版本：Windows 8及更高版本的 Windows 中的_Supported
标头	bthddi.h (包括 Bthddi.h)

通过

INDICATION_PARAMETERS_ENHANCED 结构 (bthddi.h)

语法

成员

要求

反馈

其他资源