_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 :

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 :

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é.

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 :

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.

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.

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.

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