PFNBTHPORT_INDICATION_CALLBACK fonction de rappel (bthddi.h)

Article
02/26/2024

Les pilotes de profil implémentent une fonction de rappel L2CAP pour fournir à la pile de pilotes Bluetooth un mécanisme permettant d’informer le pilote de profil des demandes de connexion L2CAP entrantes provenant d’appareils distants et de toute modification apportée au status d’une connexion L2CAP actuellement ouverte.

Syntaxe

PFNBTHPORT_INDICATION_CALLBACK PfnbthportIndicationCallback;

void PfnbthportIndicationCallback(
  [in] PVOID Context,
  [in] INDICATION_CODE Indication,
  [in] PINDICATION_PARAMETERS Parameters
)
{...}

Paramètres

[in] Context

Pour les indications de demande de connexion à distance entrante, il s’agit du contexte spécifié par le pilote de profil dans le membre IndicationCallbackContext du _BRB_L2CA_REGISTER_SERVER structure lorsque le pilote de profil a inscrit la fonction de rappel. Pour les modifications apportées aux connexions L2CAP existantes, il s’agit du membre CallbackContext spécifié par le pilote de profil lorsqu’il a généré et envoyé un _BRB_L2CA_OPEN_CHANNEL BRB.

[in] Indication

Valeur INDICATION_CODE qui indique le type d’événement L2CAP.

[in] Parameters

Structure INDICATION_PARAMETERS qui contient des paramètres spécifiques à l’événement.

Valeur de retour

None

Remarques

Un pilote de profil inscrit sa fonction de rappel L2CAP dans les deux scénarios suivants :

Lorsqu’un pilote de profil agit en tant que serveur, il inscrit une fonction de rappel L2CAP à l’aide du membre IndicationCallback du _BRB_L2CA_REGISTER_SERVER structure. La pile de pilotes Bluetooth peut ensuite avertir le pilote de profil lorsqu’un périphérique distant tente de le contacter.
Lorsque le pilote de profil agit en tant que client et tente de se connecter à un périphérique distant à l’aide du BRB_L2CA_OPEN_CHANNEL BRB, le pilote de profil enregistre sa fonction de rappel L2CAP à l’aide du membre De rappel de la structure _BRB_L2CA_OPEN_CHANNEL qui est passé lorsque le pilote de profil génère et envoie un BRB_L2CA_OPEN_CHANNEL ou BRB_L2CA_OPEN_CHANNEL_RESPONSE demande.

Une fois que le pilote de profil a inscrit sa fonction de rappel L2CAP, la fonction de rappel est uniquement associée au canal ouvert par le BRB. La pile de pilotes Bluetooth peut appeler la fonction de rappel L2CAP pour informer le pilote de profil des actions qui se produisent sur le canal ouvert de l’appareil distant. Les pilotes de profil peuvent inscrire une fonction de rappel unique pour gérer les notifications de canal en tant que client et les notifications de connexion en tant que serveur.

La structure INDICATION_PARAMETERS contenue dans le paramètre Parameters est interprétée en fonction de la valeur de l’énumération INDICATION_CODE que la pile de pilotes Bluetooth transmet à la fonction de rappel L2CAP du pilote de profil via le paramètre Indication . Pour la plupart des notifications, il existe un membre d’union INDICATION_PARAMETERS qui correspond à l’événement et contient des paramètres spécifiques à l’événement.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Versions :_Supported dans Windows Vista et versions ultérieures.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	bthddi.h (inclure Bthddi.h)
IRQL	Les développeurs doivent coder cette fonction pour fonctionner dans IRQL = DISPATCH_LEVEL (si la fonction de rappel n’accède pas à la mémoire paginée) ou IRQL = PASSIVE_LEVEL (si la fonction de rappel doit accéder à la mémoire paginée)

Voir aussi

INDICATION_CODE

INDICATION_PARAMETERS

_BRB_L2CA_OPEN_CHANNEL

_BRB_L2CA_REGISTER_SERVER

Partager via