共用方式為


INDICATION_PARAMETERS_ENHANCED 結構 (bthddi.h)

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

當 Enhanced callback 函式的指示參數中指定了 IndicationRemoteConnect INDICATION_CODE 值時,傳遞至呼叫函式的 Protocol/Service Multiplexer (PSM) 。

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 Windows 8 和更新版本中的版本:_Supported
標頭 bthddi.h (包含 Bthddi.h)