次の方法で共有


_BRB_L2CA_UPDATE_CHANNEL構造体 (bthddi.h)

_BRB_L2CA_UPDATE_CHANNEL構造体は、開いている L2CAP チャネルのリモート デバイスへのリンク特性の更新、または特定のチャネル属性が変更されたタイミングを確認するための更新を記述します。

構文

struct _BRB_L2CA_UPDATE_CHANNEL {
  BRB_HEADER           Hdr;
  BTH_ADDR             BtAddress;
  L2CAP_CHANNEL_HANDLE ChannelHandle;
  ULONG                NewChannelFlags;
  ULONG                FailedChannelFlags;
};

メンバーズ

Hdr

現在の BRB に関する情報を含む BRB_HEADER 構造体。

BtAddress

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

ChannelHandle

以前の BRB_L2CA_OPEN_CHANNEL または Bluetoothに応答してドライバー スタックによって返された L2CAP チャネル ハンドル BRB_L2CA_OPEN_CHANNEL_RESPONSE 要求。

NewChannelFlags

チャネルの更新された要件を指定するフラグ値の組み合わせ。 このメンバーはCF_ROLE_EITHERに設定する必要があります。

FailedChannelFlags

NewChannelFlags のフラグ、Bluetooth ドライバー スタックが優先できなかったメンバーです。 このメンバーには、BRB 呼び出しが失敗した場合にのみ情報が含まれます。

備考

L2CAP チャネルの現在の設定を取得するには、プロファイル ドライバーがビルド し、BRB_L2CA_UPDATE_CHANNEL 要求 送信する必要があります。

プロファイル ドライバーは、特定のチャネル属性が変更されたタイミングを判断できます。 さらに、CF_LINK_PASSIVE_MODE フラグが設定されていない場合、BRB は現在のチャネル設定をリモート デバイスに変更しようとします。

BRB_L2CA_UPDATE_CHANNEL の主な用途は、接続に対して認証または暗号化が有効になっているタイミングを判断することです。

場合によっては、プロファイル ドライバーが認証が必要であることを指定せずに L2CAP 接続を確立できますが、ユーザーが選択したために認証が自動的に行われます。 この場合、接続が確立されてから、認証と暗号化の動作が開始するまでの期間が経過します。 BRB_L2CA_UPDATE_CHANNEL の呼び出しは、認証と暗号化が完了するまでブロックされます。

プロファイル ドライバーは、BRB_L2CA_UPDATE_CHANNEL 要求をビルドして送信することで、認証前に接続を使用することを回避できます。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista 以降のバージョン:_Supported。
ヘッダー bthddi.h (Bthddi.h を含む)

関連項目

BRB_HEADER

BRB_L2CA_OPEN_CHANNEL

BRB_L2CA_OPEN_CHANNEL_RESPONSE

BRB_L2CA_UPDATE_CHANNEL