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) |