IOCTL_BTHX_WRITE_HCI IOCTL (bthxddi.h)
IOCTL_BTHX_WRITE_HCI est utilisé pour écrire des données et des commandes de liste de contrôle d’accès Bluetooth dans la couche de transport.
Code principal
Mémoire tampon d’entrée
Les pilotes de profil doivent utiliser KMDF et sa méthode WdfRequestRetrieveInputMemory pour récupérer les paramètres d’entrée. Par exemple, pour obtenir la mémoire tampon d’entrée :
Status = WdfRequestRetrieveInputMemory(_Request, &ReqInMemory);
La mémoire tampon décrit une structure BTHX_HCI_READ_WRITE_CONTEXT qui spécifie le type d’écriture et les données associées à l’écriture.
Pour plus d’informations, reportez-vous aux exemples Bluetooth WDK.
Longueur de la mémoire tampon d’entrée
La longueur de la mémoire tampon est la taille de la structure BTHX_HCI_READ_WRITE_CONTEXT.
Mémoire tampon de sortie
Les pilotes de profil doivent utiliser KMDF et sa méthode WdfRequestRetrieveOutputMemory pour récupérer les paramètres d’entrée. Par exemple, pour obtenir la mémoire tampon de sortie :
Status = WdfRequestRetrieveOutputMemory(_Request, &ReqOutMemory);
La mémoire tampon décrit un ULONG du nombre d’octets écrits pour les données d’entrée spécifiées dans la structure BTHX_HCI_READ_WRITE_CONTEXT.
Pour plus d’informations, reportez-vous aux exemples Bluetooth WDK.
Longueur de la mémoire tampon de sortie
La longueur de la mémoire tampon est la taille d’un ULONG.
Bloc d’état
Si la demande réussit, l'Information membre de la structure STATUS_BLOCK est défini sur le nombre d’octets dans le paramètre de sortie.
Le membre Status est défini sur l’une des valeurs du tableau suivant.
| Valeur d’état | Description |
|---|---|
| STATUS_SUCCESS | Le IOCTL s’est terminé avec succès. |
Remarques
La pile Bluetooth envoie IOCTL_BTHX_WRITE_HCI pour écrire des données ACL HCI et une commande HCI sur le contrôleur.
La mémoire tampon d’entrée pointe vers une structure BTHX_HCI_READ_WRITE_CONTEXT dont membre DataLen spécifie le nombre d’octets dans le membre Data. Le type membre est défini selon que le paquet est un paquet de commandes ou un paquet de données ACL.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge à partir de Windows 8. |
| d’en-tête | bthxddi.h |
| IRQL | <= DISPATCH_LEVEL |