_BRB_L2CA_UPDATE_CHANNEL-Struktur (bthddi.h)

Artikel
02/22/2024

Die _BRB_L2CA_UPDATE_CHANNEL-Struktur beschreibt eine Aktualisierung der Linkeigenschaften eines offenen L2CAP-Kanals zu einem Remotegerät oder um festzustellen, wann sich bestimmte Kanalattribute geändert haben.

Syntax

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

Member

Hdr

Eine BRB_HEADER-Struktur , die Informationen zum aktuellen BRB enthält.

BtAddress

Die Bluetooth-Adresse des Remotegeräts.

ChannelHandle

Das L2CAP-Kanalhandle, das vom Bluetooth-Treiberstapel als Reaktion auf eine frühere BRB_L2CA_OPEN_CHANNEL oder zurückgegeben wurde BRB_L2CA_OPEN_CHANNEL_RESPONSE Anforderung.

NewChannelFlags

Eine Kombination von Flagwerten, die die aktualisierten Anforderungen für den Kanal angeben. Dieses Element sollte auf CF_ROLE_EITHER festgelegt werden.

FailedChannelFlags

Die Flags im NewChannelFlags-Member , die vom Bluetooth-Treiberstapel nicht berücksichtigt werden konnten. Dieser Member enthält nur Informationen, wenn beim BRB-Aufruf ein Fehler aufgetreten ist.

Hinweise

Um die aktuellen Einstellungen eines L2CAP-Kanals abzurufen, sollten Profiltreiber eine BRB_L2CA_UPDATE_CHANNEL Anforderung erstellen und senden.

Der Profiltreiber kann dann bestimmen, wann sich bestimmte Kanalattribute geändert haben. Wenn das CF_LINK_PASSIVE_MODE-Flag nicht festgelegt ist, versucht der BRB außerdem, die aktuellen Kanaleinstellungen auf das Remotegerät zu ändern.

Die primäre Verwendung von BRB_L2CA_UPDATE_CHANNEL besteht darin, zu bestimmen, wann die Authentifizierung oder Verschlüsselung für eine Verbindung aktiviert wurde.

In einigen Fällen können L2CAP-Verbindungen hergestellt werden, ohne dass der Profiltreiber angibt, dass die Authentifizierung erforderlich ist. Die Authentifizierung erfolgt jedoch automatisch aufgrund von Entscheidungen des Benutzers. In diesem Fall vergeht ein Zeitraum zwischen dem Herstellen der Verbindung und dem Beginn der Authentifizierung und Verschlüsselung. Aufrufe an BRB_L2CA_UPDATE_CHANNEL werden blockiert, bis die Authentifizierung und Verschlüsselung abgeschlossen sind.

Durch das Erstellen und Senden einer BRB_L2CA_UPDATE_CHANNEL Anforderung können Profiltreiber vermeiden, die Verbindung vor der Authentifizierung zu verwenden.