_BRB_L2CA_OPEN_ENHANCED_CHANNEL structure (bthddi.h)
La structure _BRB_L2CA_OPEN_ENHANCED_CHANNEL permet d’ouvrir un canal L2CAP amélioré sur un appareil distant ou d’envoyer une réponse pour accepter/rejeter une demande de connexion L2CAP améliorée entrante initiée par un appareil distant.
Syntaxe
struct _BRB_L2CA_OPEN_ENHANCED_CHANNEL {
BRB_HEADER Hdr;
L2CAP_CHANNEL_HANDLE ChannelHandle;
union {
struct {
USHORT Response;
USHORT ResponseStatus;
};
USHORT Psm;
};
ULONG ChannelFlags;
BTH_ADDR BtAddress;
struct {
ULONG Flags;
L2CAP_CONFIG_VALUE_RANGE Mtu;
L2CAP_CONFIG_VALUE_RANGE FlushTO;
L2CAP_FLOWSPEC Flow;
USHORT LinkTO;
ULONG NumExtraOptions;
PL2CAP_CONFIG_OPTION ExtraOptions;
struct {
UCHAR ServiceType;
ULONG Latency;
} LocalQos;
struct {
ULONG Flags;
L2CAP_RETRANSMISSION_AND_FLOW_CONTROL RetransmissionAndFlow;
} ModeConfig;
USHORT Fcs;
L2CAP_EXTENDED_FLOW_SPEC ExtendedFlowSpec;
USHORT ExtendedWindowSize;
} ConfigOut;
struct {
ULONG Flags;
L2CAP_CONFIG_VALUE_RANGE Mtu;
L2CAP_CONFIG_RANGE FlushTO;
} ConfigIn;
ULONG CallbackFlags;
PFNBTHPORT_INDICATION_CALLBACK_ENHANCED Callback;
PVOID CallbackContext;
PVOID ReferenceObject;
CHANNEL_CONFIG_RESULTS_ENHANCED OutResults;
CHANNEL_CONFIG_RESULTS_ENHANCED InResults;
UCHAR IncomingQueueDepth;
PVOID Reserved;
};
Membres
Hdr
Structure BRB_HEADER qui contient des informations sur le BRB actuel.
ChannelHandle
Handle utilisé pour identifier la connexion lors d’une connexion réussie. Lors de l’envoi d’une BRB_L2CA_OPEN_CHANNEL, celle-ci est renseignée lorsque le BRB se termine. Lors de l’envoi d’une demande de BRB_L2CA_OPEN_CHANNEL_RESPONSE, celle-ci doit être renseignée par le serveur avant d’envoyer le BRB. La valeur affectée doit être INDICATION_PARAMETERS::ConnectionHandle celle qui a été passée pendant indicationRemoteConnect.
Response
Utilisé uniquement avec BRB_L2CA_OPEN_CHANNEL_RESPONSE. L’une des valeurs CONNECT_RSP_RESULT_Xxx est utilisée.
Si le BRB retourne avec une status de STATUS_REQUEST_NOT_ACCEPTED, Response contient la réponse négative de l’hôte distant.
ResponseStatus
Si La réponse est égale à CONNECT_RSP_RESULT_PENDING, ce champ est valide. L’une des valeurs CONNECT_RSP_STATUS_XXX est utilisée.
Psm
Multiplexeur de protocole/service (PSM) que le canal utilise pour se connecter à l’appareil distant. Lorsqu’il est utilisé avec une demande de BRB_L2CA_OPEN_ENHANCED_CHANNEL , ce membre est défini en tant que champ d’entrée. Lorsqu’il est utilisé avec une demande BRB_L2CA_OPEN_ENHANCED_CHANNEL_RESPONSE , ce membre est utilisé comme champ de sortie.
ChannelFlags
Indicateurs qui spécifient la configuration requise pour l’ouverture du canal. Les valeurs d’indicateur valides sont répertoriées dans le tableau suivant :
| Indicateur | Description |
|---|---|
| CF_LINK_AUTHENTICATED | Le lien doit être authentifié. |
| CF_LINK_ENCRYPTED | Le lien doit être chiffré. La définition de cet indicateur définit également l’indicateur CF_LINK_AUTHENTICATED. |
| CF_LINK_SUPPRESS_PIN | Le pilote de profil indique qu’il préfère que les utilisateurs ne soient pas invités à entrer un code confidentiel. |
BtAddress
Adresse Bluetooth de l’appareil pour lequel la connexion est prévue.
ConfigOut
Sous-structure qui contient les paramètres d’un BRB_L2CA_OPEN_ENHANCED_CHANNEL BRB envoyé à un appareil distant.
ConfigOut.Flags
Indicateurs qui spécifient la configuration requise pour l’ouverture du canal. Les valeurs d’indicateur valides sont répertoriées dans le tableau suivant :
| Indicateur | Description |
|---|---|
| CF_LINK_AUTHENTICATED | Le lien doit être authentifié. |
| CF_LINK_ENCRYPTED | Le lien doit être chiffré. La définition de cet indicateur définit également l’indicateur CF_LINK_AUTHENTICATED. |
| CF_LINK_SUPPRESS_PIN | Le pilote de profil indique qu’il préfère que les utilisateurs ne soient pas invités à entrer un code confidentiel. |
| CFG_ENHANCED | Spécifie que la structure ModeConfig est valide. |
| CFG_FCS | Spécifie que la valeur Fcs est valide. |
ConfigOut.Mtu
Plage d’unités de transfert de messages (MTU) utilisée pour négocier la taille de la moitié sortante du canal.
ConfigOut.FlushTO
Plage de valeurs possibles à utiliser pour le délai d’expiration du vidage pour la moitié sortante du canal.
ConfigOut.Flow
Réservé pour un usage futur. Ne pas utiliser.
ConfigOut.LinkTO
Délai d’expiration du lien du Gestionnaire de liens.
ConfigOut.NumExtraOptions
Nombre d’éléments de tableau contenus dans le membre ExtraOptions . Cette valeur doit être égale à zéro pour la plupart des clients.
ConfigOut.ExtraOptions
Options supplémentaires. Cette valeur doit être égale à zéro pour la plupart des clients.
ConfigOut.LocalQos
Réservé pour un usage futur. Ne pas utiliser.
ConfigOut.LocalQos.ServiceType
Réservé pour un usage futur. Ne pas utiliser.
ConfigOut.LocalQos.Latency
Réservé pour un usage futur. Ne pas utiliser.
ConfigOut.ModeConfig
Spécifie le type de canal L2CAP en cours d’ouverture. Cette structure est valide uniquement si CFG_ENHANCED indicateur est spécifié.
ConfigOut.ModeConfig.Flags
Spécifie le type de mode de canal L2CAP demandé.
| Indicateur | Description |
|---|---|
| CM_BASIC | Ouvrez un canal en mode de base. |
| CM_RETRANSMISSION_AND_FLOW | Ouvrez un canal en mode de retransmission amélioré. |
| CM_STREAMING | Ouvrez un canal en mode streaming. |
ConfigOut.ModeConfig.RetransmissionAndFlow
Spécifie les options pour les modes CM_RETRANSMISSION_AND_FLOW et CM_STREAMING. Cette structure doit être égale à zéro si seul CM_BASIC est spécifié dans le membre Flags .
Le sous-membre Mode de RetransmissionAndFlow doit avoir la valeur 0. Utilisez le sous-membre ModeConfig de RetransmissionAndFlow pour spécifier le type de canal à ouvrir.
ConfigOut.Fcs
Spécifie si FCS doit être utilisé pour le canal L2CAP amélioré. Cette valeur est valide uniquement si CM_RETRANSMISSION_AND_FLOW ou CM_STREAMING indicateur est spécifié dans le membre Flags .
ConfigOut.ExtendedFlowSpec
Non pris en charge.
ConfigOut.ExtendedWindowSize
Non pris en charge.
ConfigIn
Sous-structure qui contient des paramètres pour valider les BRB_L2CA_OPEN_ENHANCED_CHANNEL_RESPONSE brbs entrants envoyés à partir d’un appareil distant.
ConfigIn.Flags
Indicateurs qui spécifient la configuration requise pour l’ouverture du canal. Les valeurs d’indicateur valides sont répertoriées dans le tableau suivant :
| Indicateur | Description |
|---|---|
| CF_LINK_AUTHENTICATED | Le lien doit être authentifié. |
| CF_LINK_ENCRYPTED | Le lien doit être chiffré. La définition de cet indicateur définit également l’indicateur CF_LINK_AUTHENTICATED. |
| CF_LINK_SUPPRESS_PIN | Le pilote de profil indique qu’il préfère que les utilisateurs ne soient pas invités à entrer un code confidentiel. |
ConfigIn.Mtu
Plage d’unités de transfert de messages (MTU) utilisée pour négocier la taille de la moitié entrante du canal.
ConfigIn.FlushTO
Plage de valeurs possibles à utiliser pour le délai d’expiration du vidage pour la moitié entrante du canal.
CallbackFlags
Indicateur qui spécifie les événements qui doivent générer une routine de rappel pour informer le pilote de profil que l’événement s’est produit. Les valeurs d’indicateur valides sont contenues dans le tableau suivant.
| Indicateur | Description |
|---|---|
| CALLBACK_CONFIG_EXTRA_IN | Si elle est définie, la routine de rappel est appelée lorsque la demande de configuration pour l’appareil distant contient des options supplémentaires. Si elles ne sont pas définies, les options de configuration supplémentaires sont rejetées en tant qu’options inconnues. Cet indicateur est utilisé avec BRB_L2CA_OPEN_ENHANCED_CHANNEL_RESPONSE brbs. |
| CALLBACK_CONFIG_EXTRA_OUT | Si elle est définie, la routine de rappel est appelée lorsque l’appareil distant rejette une option de configuration supplémentaire à partir d’une demande de BRB_L2CA_OPEN_ENHANCED_CHANNEL . Si ce n’est pas défini et que l’appareil distant rejette la demande de configuration en raison d’une option supplémentaire, la connexion est fermée. |
| CALLBACK_CONFIG_QOS | Si elle est définie, la routine de rappel est appelée lorsqu’un appareil distant envoie une demande de configuration qui contient une valeur QOS. Si cet indicateur n’est pas défini et que l’appareil distant envoie les paramètres QOS dans une demande de configuration ou rejette les paramètres QOS demandés par le pilote de profil, la connexion est déconnectée. |
| CALLBACK_DISCONNECT | Si elle est définie, la routine de rappel est appelée lorsqu’un appareil distant se déconnecte du canal L2CAP amélioré. |
| CALLBACK_RECV_PACKET | Si elle est définie, la routine de rappel est appelée lorsque le pilote de profil reçoit un paquet L2CAP amélioré entrant. |
Callback
Fonction de rappel L2CAP améliorée implémentée par le pilote de profil, que la pile de pilotes Bluetooth doit appeler pour informer le pilote de profil de toute modification apportée à la connexion L2CAP améliorée.
CallbackContext
Contexte à passer à la fonction de rappel spécifiée dans le membre Callback . Le pilote de profil définit cette valeur.
ReferenceObject
Pointeur vers un objet à passer à ObReferenceObject et ObDereferenceObject pour lequel conserver un nombre de références.
OutResults
Structure CHANNEL_CONFIG_RESULTS_ENHANCED qui contient les paramètres de configuration négociés pour la requête sortante.
InResults
Structure CHANNEL_CONFIG_RESULTS_ENHANCED qui contient les paramètres de configuration négociés pour la demande entrante.
IncomingQueueDepth
Spécifie la longueur de la file d’attente entrante dans les unités de transfert de messages (MTU).
Reserved
Membre réservé. Ne pas utiliser.
response
Ce membre est utilisé comme paramètre d’entrée pour une demande de BRB_L2CA_OPEN_ENHANCED_CHANNEL et comme paramètre de sortie pour la requête BRB_L2CA_OPEN_ENHANCED_CHANNEL_RESPONSE .
Pour une demande de BRB_L2CA_OPEN_ENHANCED_CHANNEL_RESPONSE , ce membre contient un indicateur qui indique la réponse du pilote de profil à l’appareil distant. Les valeurs d’indicateur valides sont contenues dans le tableau suivant.
| Indicateur | Description |
|---|---|
| CONNECT_RSP_RESULT_NO_RESOURCES | Le pilote de profil a refusé la connexion en raison d’un manque de ressources. |
| CONNECT_RSP_RESULT_PENDING | Le pilote de profil est actuellement occupé et ne peut pas accepter la connexion. Réessayez plus tard. |
| CONNECT_RSP_RESULT_PSM_NEG | Le pilote de profil a refusé la connexion, car le PSM n’est pas pris en charge. |
| CONNECT_RSP_RESULT_SECURITY_BLOCK | Le pilote de profil a refusé la connexion pour des raisons de sécurité. |
| CONNECT_RSP_RESULT_SUCCESS | Le pilote de profil a accepté la connexion. |
Pour le BRB_L2CA_OPEN_ENHANCED_CHANNEL BRB, ce membre contient la réponse de l’appareil distant auquel le pilote de profil a tenté de se connecter. Les valeurs d’indicateur valides sont contenues dans le tableau suivant.
| Indicateur | Description |
|---|---|
| CONNECT_RSP_RESULT_NO_RESOURCES | L’appareil distant a refusé la connexion en raison d’un manque de ressources. |
| CONNECT_RSP_RESULT_PSM_NEG | L’appareil distant a refusé la connexion. |
| CONNECT_RSP_RESULT_SECURITY_BLOCK | L’appareil distant a refusé la connexion pour des raisons de sécurité. |
| CONNECT_RSP_RESULT_SUCCESS | L’appareil distant a accepté la connexion. |
ResponseStatus
Si, lors d’un appel au BRB_L2CA_OPEN_ENHANCED_CHANNEL_RESPONSE BRB, le membre Response est défini sur CONNECT_RSP_RESULT_PENDING, ce membre est valide et contient l’une des valeurs suivantes :
- CONNECT_RSP_STATUS_AUTHENTICATION_PENDING
- CONNECT_RSP_STATUS_AUTHORIZATION_PENDING
- CONNECT_RSP_STATUS_NO_INFORMATION
Remarques
Les pilotes de profil peuvent utiliser CM_BASIC | CM_RETRANSMISSION_AND_FLOWles modes ou CM_BASIC | CM_STREAMING pour le membre Flags . Cela indique d’ouvrir un mode de retransmission amélioré, ou un canal en mode streaming si possible, et si ce n’est pas revenir au canal en mode de base.
La valeur de n’est CM_RETRANSMISSION_AND_FLOW | CM_STREAMING pas prise en charge.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Versions :_Supported dans les versions Windows 8 et ultérieures de Windows |
| En-tête | bthddi.h (inclure Bthddi.h) |
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour