_BRB_L2CA_UPDATE_CHANNEL 構造体 (bthddi.h)

[アーティクル]
02/22/2024

_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

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

注釈

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

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

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

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

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