_BRB_L2CA_UPDATE_CHANNEL-Struktur (bthddi.h)
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Versionen:_Supported in Windows Vista und höher. |
| Kopfzeile | bthddi.h (include Bthddi.h) |