PFNSCO_INDICATION_CALLBACK fonction de rappel (bthddi.h)
Les pilotes de profil implémentent une fonction de rappel SCO pour fournir à la pile des pilotes Bluetooth un mécanisme permettant de notifier le pilote de profil sur les demandes de connexion SCO entrantes à partir d’appareils distants, ainsi que les modifications apportées à l’état d’une connexion SCO actuellement ouverte.
Syntaxe
PFNSCO_INDICATION_CALLBACK PfnscoIndicationCallback;
void PfnscoIndicationCallback(
[in] PVOID Context,
[in] SCO_INDICATION_CODE Indication,
[in] PSCO_INDICATION_PARAMETERS Parameters
)
{...}
Paramètres
[in] Context
Pour les indications de demande de connexion distante entrante, il s’agit du contexte spécifié par le pilote de profil dans le IndicationCallbackContext membre de la structure _BRB_SCO_REGISTER_SERVER lorsque le pilote de profil a inscrit la fonction de rappel. Pour les modifications apportées aux connexions SCO existantes, il s’agit de la CallbackContext membre spécifié par le pilote de profil lorsqu’il a généré et envoyé une BRB_SCO_OPEN_CHANNEL BRB.
[in] Indication
Valeur SCO_INDICATION_CODE qui indique le type d’événement SCO.
[in] Parameters
Un SCO_INDICATION_PARAMETERS structure qui contient des informations de paramètre en fonction de la valeur transmise au paramètre d’indication .
Valeur de retour
Aucun
Remarques
Le membre BtAddress trouvé dans la structure de SCO_INDICATION_PARAMETERS passée dans le paramètre Parameters indique l’adresse Bluetooth de l’appareil distant.
La fonction PFNSCO_INDICATION_CALLBACK peut être inscrite de deux façons.
Dans le premier cas, le pilote de profil agit en tant que serveur et doit inscrire cette fonction de rappel via l'IndicationCallback membre de la structure _BRB_SCO_REGISTER_SERVER. La pile de pilotes Bluetooth peut ensuite appeler cette fonction pour notifier le pilote de profil lorsqu’un appareil distant tente de le contacter.
Dans le deuxième cas, le pilote de profil agit en tant que client et tente de se connecter à un appareil distant à l’aide du BRB_SCO_OPEN_CHANNEL BRB. La fonction de rappel PFNSCO_INDICATION_CALLBACK est inscrite via le membre callback de la structure _BRB_SCO_OPEN_CHANNEL passée avec le BRB spécifié lorsqu’un d’entre eux est soumis via IOCTL_INTERNAL_BTH_SUBMIT_BRB.
Une fois inscrite, la fonction de rappel est uniquement associée au canal ouvert par le BRB, et la fonction informe le pilote de profil des actions qui se produisent sur le canal ouvert sur l’appareil distant. Les pilotes de profil peuvent inscrire une fonction unique pour gérer les notifications de canal en tant que client et _BRB_SCO_REGISTER_SERVER notifications en tant que serveur.
La structure SCO_INDICATION_PARAMETERS conservée dans le paramètre Parameters est interprétée en fonction de la valeur SCO_INDICATION_CODE transmise à la fonction de rappel via le paramètre Indication. Pour la plupart des notifications, il existe un membre d’union SCO_INDICATION_PARAMETERS qui correspond à l’événement et contient des paramètres spécifiques à l’événement.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Versions :_Supported dans Windows Vista et versions ultérieures. |
| plateforme cible | Bureau |
| d’en-tête | bthddi.h (include Bthddi.h) |
| IRQL | Les développeurs doivent coder cette fonction pour fonctionner sur 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) |