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

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

Parameters

Parameters.Connect

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

Parameters.Connect.Request

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

Parameters.Connect.Request.PSM

コールバック関数の Indication パラメーターで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

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

Parameters.Disconnect.CloseNow

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

Parameters.RecvPacket

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

Parameters.RecvPacket.PacketLength

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

Parameters.RecvPacket.TotalQueueLength

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

注釈

プロファイルドライバーの L2CAP コールバック関数は、Bluetooth ドライバースタックがコールバック関数の Indication パラメーターで渡す値に応じて、この構造を異なる方法で処理する必要があります。

Bluetooth ドライバースタックが IndicationRemoteConnect に合格すると、コールバック関数は Parameters 共用体の Connect メンバーを使用する必要があります。
Bluetooth ドライバースタックが IndicationRemoteDisconnect に合格すると、コールバック関数は Parameters 共用体の Disconnect メンバーを使用する必要があります。
Bluetooth ドライバースタックが IndicationRemoteConfigRequest に合格すると、コールバック関数は Parameters 共用体の ConfigRequest メンバーを使用する必要があります。
Bluetooth ドライバースタックが IndicationRemoteConfigResponse に合格すると、コールバック関数は Parameters 共用体の ConfigResponse メンバーを使用する必要があります。
Bluetooth ドライバースタックが IndicationRemoteFreeExtraOptions を渡す場合、コールバック関数は Parameters 共用体の FreeExtraOptions メンバーを使用する必要があります。
Bluetooth ドライバースタックが IndicationRemoteRecvPacket に合格すると、コールバック関数は Parameters 共用体の RecvPacket メンバーを使用する必要があります。