INDICATION_PARAMETERS_ENHANCED構造体 (bthddi.h)

[アーティクル]
03/08/2023

INDICATION_PARAMETERS_ENHANCED構造体は、パラメーターパラメーターとしてプロファイルドライバーの拡張 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

リモートデバイスの Bluetooth アドレス。

Parameters

Parameters.Connect

IndicationRemoteConnect コールバック関数のパラメーターを含む構造体。

Parameters.Connect.Request

接続要求のパラメーターを含む構造体。

Parameters.Connect.Request.PSM

拡張コールバック関数の Indication パラメーターで IndicationRemoteConnect INDICATION_CODE値が指定されている場合に呼び出し元関数に渡されるプロトコル/サービスマルチプレクサー (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

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 接続が終了した理由を示す L2CAP_DISCONNECT_REASON 値。

Parameters.Disconnect.CloseNow

プロファイルドライバーが L2CAP 接続を閉じるために Bluetooth ドライバースタックに通知するために使用するブール値。接続を閉じる Bluetooth ドライバースタックに通知するには、このメンバーを TRUE に 設定します。それ以外の場合は、接続を開いたままにする 場合は FALSE に 設定します。

Parameters.RecvPacket

IndicationRecvPacket INDICATION_CODE値のパラメーターを含む構造体。

Parameters.RecvPacket.PacketLength

コールバック関数が L2CAP 接続経由で送信したパケットのサイズ (バイト単位)。

Parameters.RecvPacket.TotalQueueLength

L2CAP 接続経由で処理されるパケットの数。

Parameters.Reserved

予約済みメンバー。使用しないでください。

要件

要件	値
サポートされている最小のクライアント	Windows 8 以降のバージョンの Windows のバージョン:_Supported
Header	bthddi.h (Bthddi.h を含む)

次の方法で共有

INDICATION_PARAMETERS_ENHANCED構造体 (bthddi.h)

構文

メンバー

要件

フィードバック

その他のリソース