_BRB_L2CA_UPDATE_CHANNEL structure (bthddi.h)

La structure _BRB_L2CA_UPDATE_CHANNEL décrit une mise à jour des caractéristiques de liaison d’un canal L2CAP ouvert vers un appareil distant ou pour déterminer si certains attributs de canal ont changé.

Syntaxe

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

Membres

Hdr

Structure BRB_HEADER qui contient des informations sur le BRB actuel.

BtAddress

Adresse Bluetooth de l’appareil distant.

ChannelHandle

Handle de canal L2CAP qui a été retourné par la pile de pilotes Bluetooth en réponse à un BRB_L2CA_OPEN_CHANNEL antérieur ou BRB_L2CA_OPEN_CHANNEL_RESPONSE demande.

NewChannelFlags

Combinaison de valeurs d’indicateur qui spécifient les exigences mises à jour pour le canal. Ce membre doit être défini sur CF_ROLE_EITHER.

FailedChannelFlags

Indicateur ou indicateurs dans le membre NewChannelFlags que la pile de pilotes Bluetooth n’a pas pu honorer. Ce membre contient des informations uniquement si l’appel BRB a échoué.

Remarques

Pour récupérer les paramètres actuels d’un canal L2CAP, les pilotes de profil doivent générer et envoyer une demande de BRB_L2CA_UPDATE_CHANNEL .

Le pilote de profil peut ensuite déterminer quand certains attributs de canal ont changé. En outre, si l’indicateur CF_LINK_PASSIVE_MODE n’est pas défini, le BRB tente de modifier les paramètres de canal actuels sur l’appareil distant.

L’utilisation principale de BRB_L2CA_UPDATE_CHANNEL est de déterminer quand l’authentification ou le chiffrement a été activé pour une connexion.

Dans certains cas, les connexions L2CAP peuvent être établies sans que le pilote de profil spécifie que l’authentification est requise, mais l’authentification se produit automatiquement en raison des choix effectués par l’utilisateur. Dans ce cas, un délai s’écoule entre le moment où la connexion est établie et le moment où l’authentification et le chiffrement commencent à fonctionner. Les appels à BRB_L2CA_UPDATE_CHANNEL sont bloqués jusqu’à ce que l’authentification et le chiffrement soient terminés.

En créant et en envoyant une demande de BRB_L2CA_UPDATE_CHANNEL , les pilotes de profil peuvent éviter d’utiliser la connexion avant l’authentification.

Configuration requise

Voir aussi

BRB_HEADER

BRB_L2CA_OPEN_CHANNEL

BRB_L2CA_UPDATE_CHANNEL