INDICATION_PARAMETERS結構 (bthddi.h)

發行項
02/22/2024

INDICATION_PARAMETERS 結構會當做Parameters參數傳遞至配置檔驅動程式的L2CAP回呼函式

語法

typedef struct _INDICATION_PARAMETERS {
  L2CAP_CHANNEL_HANDLE ConnectionHandle;
  IN BTH_ADDR          BtAddress;
  union {
    struct {
      struct {
        OUT USHORT PSM;
      } Request;
    } Connect;
    struct {
      CHANNEL_CONFIG_PARAMETERS CurrentParams;
      CHANNEL_CONFIG_PARAMETERS RequestedParams;
      CHANNEL_CONFIG_PARAMETERS ResponseParams;
      USHORT                    Response;
    } ConfigRequest;
    struct {
      CHANNEL_CONFIG_PARAMETERS CurrentParams;
      CHANNEL_CONFIG_PARAMETERS RequestedParams;
      CHANNEL_CONFIG_PARAMETERS RejectedParams;
      PCO_TYPE                  UnknownTypes;
      ULONG                     NumUnknownTypes;
      CHANNEL_CONFIG_PARAMETERS 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;
  } Parameters;
} *PINDICATION_PARAMETERS, INDICATION_PARAMETERS;

成員

ConnectionHandle

遠端裝置的 L2CAP 連線句柄。此句柄只適用於透過已建立 L2CAP 連線送達的通知。

BtAddress

遠端裝置的藍牙位址。

Parameters

Parameters.Connect

結構，包含 IndicationRemoteConnect 回 呼函式的參數。

Parameters.Connect.Request

結構，包含連接要求的參數。

Parameters.Connect.Request.PSM

當回呼函式的指示參數中指定IndicationRemoteConnectINDICATION_CODE值時，會傳遞至呼叫函式的通訊協定/服務多任務器 ( PSM) 。

Parameters.ConfigRequest

結構，包含 IndicationRemoteConfigRequestINDICATION_CODE 值的參數。

Parameters.ConfigRequest.CurrentParams

包含目前通道參數的CHANNEL_CONFIG_PARAMETERS 結構。只有當通道先前已開啟且目前正在設定時，這個值才有效。回呼函式指定 IndicationRemoteConfigRequestINDICATION_CODE 值時，會使用此成員。

Parameters.ConfigRequest.RequestedParams

CHANNEL_CONFIG_PARAMETERS結構，其中包含從遠端主機針對組態要求傳遞的參數。回呼函式指定 IndicationRemoteConfigRequestINDICATION_CODE 值時，會使用此成員。

Parameters.ConfigRequest.ResponseParams

CHANNEL_CONFIG_PARAMETERS結構，其中包含配置檔驅動程式回應組態要求的參數。

Parameters.ConfigRequest.Response

表示組態要求狀態的旗標。下表列出有效的旗標值。

旗標	描述
CONFIG_STATUS_SUCCESS	設定要求成功。
CONFIG_STATUS_DISCONNECT	設定要求失敗，因為 L2CAP 連線已中斷連線。
CONFIG_STATUS_INVALID_PARAMETER	組態要求失敗，因為無效的參數已傳遞至配置文件驅動程式。
CONFIG_STATUS_REJECT	配置檔驅動程式拒絕了設定要求。
CONFIG_STATUS_UNKNOWN_OPTION	組態要求失敗，因為配置檔驅動程式無法辨識其中一個指定的組態選項。

Parameters.ConfigResponse

結構，包含 IndicationRemoteConfigResponseINDICATION_CODE 值的參數。

Parameters.ConfigResponse.CurrentParams

Parameters.ConfigResponse.RequestedParams

CHANNEL_CONFIG_PARAMETERS結構，其中包含從遠端主機針對組態要求傳遞的參數。回呼函式指定 IndicationRemoteConfigRequestINDICATION_CODE 值時，會使用此成員。

Parameters.ConfigResponse.RejectedParams

*CHANNEL_CONFIG_PARAMETERS 結構，其中包含遠端裝置拒絕的組態參數設定。

Parameters.ConfigResponse.UnknownTypes

回應裝置無法辨識的類型陣列。

Parameters.ConfigResponse.NumUnknownTypes

UnknownTypes 成員中無法辨識的類型數目。

Parameters.ConfigResponse.NewRequestParams

*CHANNEL_CONFIG_PARAMETERS 結構，其中包含回呼函式的參數設定，以在從遠端裝置傳回響應之後重新提交。

Parameters.ConfigResponse.Response

表示組態要求狀態的旗標。下表列出有效的旗標值。

旗標	描述
CONFIG_STATUS_SUCCESS	設定要求成功。
CONFIG_STATUS_DISCONNECT	設定要求失敗，因為 L2CAP 連線已中斷連線。
CONFIG_STATUS_INVALID_PARAMETER	組態要求失敗，因為無效的參數已傳遞至配置文件驅動程式。
CONFIG_STATUS_REJECT	配置檔驅動程式拒絕了設定要求。
CONFIG_STATUS_UNKNOWN_OPTION	組態要求失敗，因為配置檔驅動程式無法辨識其中一個指定的組態選項。

Parameters.FreeExtraOptions

結構，包含 IndicationFreeExtraOptionsINDICATION_CODE 值的參數。

Parameters.FreeExtraOptions.NumExtraOptions

ExtraOptions 成員中包含的額外選項數目。

Parameters.FreeExtraOptions.ExtraOptions

ExtraOptions 成員中包含的額外選項數目。

Parameters.Disconnect

結構，包含 IndicationRemoteDisconnectINDICATION_CODE 值的參數。

Parameters.Disconnect.Reason

L2CAP_DISCONNECT_REASON值，指出遠端裝置的 L2CAP 連線為何終止。

Parameters.Disconnect.CloseNow

配置文件驅動程式用來通知藍牙驅動程式堆疊關閉 L2CAP 連線的布爾值。將此成員設定為 TRUE ，以通知藍牙驅動程式堆疊關閉連線。否則，請將它設定為 FALSE 以保持連線開啟。

Parameters.RecvPacket

結構，包含 IndicationRecvPacketINDICATION_CODE 值的參數。

Parameters.RecvPacket.PacketLength

回呼函式透過 L2CAP 連線傳送的封包大小，以位元組為單位。

Parameters.RecvPacket.TotalQueueLength

要透過 L2CAP 連線處理的封包數目。

備註

配置文件驅動程式的 L2CAP 回呼函式應該根據藍牙驅動程式堆疊傳入回呼函式 的指示 參數中的值，以不同的方式處理此結構。

當藍牙驅動程式堆疊傳遞 IndicationRemoteConnect 時，回呼函式應該使用 Parameters 等位的 Connect 成員。
當藍牙驅動程式堆疊傳遞 IndicationRemoteDisconnect 時，回呼函式應該使用 Parameters 等位的 Disconnect 成員。
當藍牙驅動程式堆疊傳遞 IndicationRemoteConfigRequest 時，回呼函式應該使用 Parameters 等位的 ConfigRequest 成員。
當藍牙驅動程式堆疊傳遞 IndicationRemoteConfigResponse 時，回呼函式應該使用 Parameters 等位的 ConfigResponse 成員。
當藍牙驅動程式堆疊傳遞 IndicationRemoteFreeExtraOptions 時，回呼函式應該使用 Parameters 等位的 FreeExtraOptions 成員。
當藍牙驅動程式堆疊傳遞 IndicationRemoteRecvPacket 時，回呼函式應該使用 Parameters 等位的 RecvPacket 成員。