INDICATION_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 | 指定された構成オプションの 1 つがプロファイル ドライバーによって認識されなかったため、構成要求が失敗しました。 |
Parameters.ConfigResponse
IndicationRemoteConfigResponseINDICATION_CODE 値のパラメーターを含む構造体。
Parameters.ConfigResponse.CurrentParams
現在のチャネルのパラメーターを含む CHANNEL_CONFIG_PARAMETERS 構造体。 この値は、チャネルが以前に開いていて、現在構成中の場合にのみ有効です。 このメンバーは、コールバック関数が IndicationRemoteConfigRequestINDICATION_CODE 値を指定するときに使用されます。
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 | 指定された構成オプションの 1 つがプロファイル ドライバーによって認識されなかったため、構成要求が失敗しました。 |
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 ドライバー スタックに通知するために使用するブール値。 このメンバーを TRUE に設定して、接続を閉じるBluetooth ドライバー スタックに通知します。 それ以外の場合は、接続を開いたままにするには、FALSE を に設定します。
Parameters.RecvPacket
IndicationRecvPacketINDICATION_CODE 値のパラメーターを含む構造体。
Parameters.RecvPacket.PacketLength
コールバック関数が L2CAP 接続経由で送信したパケットのサイズ (バイト単位)。
Parameters.RecvPacket.TotalQueueLength
L2CAP 接続経由で処理されるパケットの数。
備考
プロファイル ドライバーの L2CAP コールバック関数 は、Bluetooth ドライバー スタックがコールバック関数の Indication パラメーターで渡す値に応じて、この構造体を異なる方法で処理する必要があります。
Bluetooth ドライバー スタックが IndicationRemoteConnect 渡す場合、コールバック関数は Parameters union の Connect メンバーを使用する必要があります。
Bluetooth ドライバー スタックが IndicationRemoteDisconnect 渡す場合、コールバック関数は Parameters 共用体の Disconnect メンバーを使用する必要があります。
Bluetooth ドライバー スタックが IndicationRemoteConfigRequest 渡す場合、コールバック関数は Parameters union の ConfigRequest メンバーを使用する必要があります。
Bluetooth ドライバー スタックが IndicationRemoteConfigResponse 渡す場合、コールバック関数は Parameters union の ConfigResponse メンバーを使用する必要があります。
Bluetooth ドライバー スタックが IndicationRemoteFreeExtraOptions 渡す場合、コールバック関数は Parameters union の FreeExtraOptions メンバーを使用する必要があります。
Bluetooth ドライバー スタックが IndicationRemoteRecvPacket 渡す場合、コールバック関数は Parameters union の RecvPacket メンバーを使用する必要があります。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista 以降のバージョン:_Supported。 |
| ヘッダー | bthddi.h (Bthddi.h を含む) |
関連項目
L2CAP コールバック関数 の