_BRB_SCO_REGISTER_SERVER structure (bthddi.h)

Article
08/07/2023

Un pilote de profil utilise la structure _BRB_SCO_REGISTER_SERVER pour s’inscrire en tant que serveur capable de recevoir des connexions SCO à partir de périphériques Bluetooth distants.

Syntaxe

struct _BRB_SCO_REGISTER_SERVER {
  BRB_HEADER                 Hdr;
  BTH_ADDR                   BtAddress;
  ULONG                      Reserved;
  ULONG                      IndicationFlags;
  PFNSCO_INDICATION_CALLBACK IndicationCallback;
  PVOID                      IndicationCallbackContext;
  PVOID                      ReferenceObject;
  SCO_SERVER_HANDLE          ServerHandle;
};

Membres

Hdr

Structure BRB_HEADER qui contient des informations sur le BRB actuel.

BtAddress

Adresse de l’appareil Bluetooth distant pour lequel recevoir des notifications.

Reserved

Réservé pour un usage futur. Ne pas utiliser.

IndicationFlags

Indicateur qui indique quand la fonction de rappel spécifiée dans le membre IndicationCallback doit être appelée. Les indicateurs suivants sont définis.

Indicateur	Description
SCO_INDICATION_SCO_REQUEST	Informez le pilote de profil s’il existe des connexions SCO entrantes.
SCO_INDICATION_ESCO_REQUEST	Informez le pilote de profil s’il existe des connexions eSCO entrantes.

IndicationCallback

Une fonction de rappel SCO, implémentée par le pilote de profil, que la pile de pilotes Bluetooth doit appeler pour informer le pilote de profil des connexions SCO entrantes.

IndicationCallbackContext

Contexte passé à la fonction définie dans le membre IndicationCallback .

ReferenceObject

Pointeur vers un objet à passer aux fonctions ObReferenceObject et ObDereferenceObject pour conserver un nombre de références. Les pilotes de profil doivent fournir cet objet de manière à ce que la pile de pilotes Bluetooth puisse augmenter le nombre de l’objet tant que la pile de pilotes peut appeler la fonction de rappel spécifiée dans le membre IndicationCallback . La pile de pilotes Bluetooth diminue le nombre de références de l’objet lorsque le pilote de profil génère et envoie un BRB_SCO_UNREGISTER_SERVER demande.

ServerHandle

Gérez le serveur SCO, en cas de retour réussi. Lorsque le pilote de profil ne doit plus recevoir d’indications de connexion à distance, il doit passer ce handle à BRB_SCO_UNREGISTER_SERVER.

Remarques

Pour s’inscrire en tant que serveur SCO, un pilote de profil doit générer et envoyer une demande de BRB_SCO_REGISTER_SERVER .

En cas de réussite, la pile de pilotes Bluetooth peut alors avertir le pilote de profil lorsque des appareils distants tentent de créer une connexion SCO au pilote de profil.

Une fois que le pilote de profil s’est inscrit, la pile de pilotes Bluetooth peut l’avertir lorsqu’un périphérique distant tente de s’y connecter en appelant la fonction de rappel SCO que le pilote de profil implémente et spécifie dans le membre IndicationCallback .

Lorsque le pilote de profil reçoit la notification d’une tentative de connexion, il doit générer et envoyer un BRB_SCO_OPEN_CHANNEL_RESPONSE demande d’accepter ou de rejeter la tentative de connexion. Pour plus d’informations sur l’acceptation ou le rejet des tentatives de connexion SCO, consultez la structure _BRB_SCO_OPEN_CHANNEL .

Une fois qu’une connexion est établie, le pilote de profil peut émettre d’autres BBR pour communiquer avec le périphérique distant.

Pour arrêter de recevoir des notifications de connexion à distance, un pilote de profil doit générer et envoyer un BRB_SCO_UNREGISTER_SERVER demande.