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 WdK Bluetooth.
Longueur de la mémoire tampon d’entrée
La longueur de la mémoire tampon correspond à 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 WdK Bluetooth.
Longueur de la mémoire tampon de sortie
La longueur de la mémoire tampon correspond à la taille d’un ULONG.
Bloc d’état
Si la demande réussit, le membre Information du STATUS_BLOCK structure 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 au contrôleur.
La mémoire tampon d’entrée pointe vers une structure BTHX_HCI_READ_WRITE_CONTEXT dont le membre DataLen spécifie le nombre d’octets dans le membre Data . Le membre Type est défini selon que le paquet est un paquet de commande ou un paquet de données ACL.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge à partir de Windows 8. |
| En-tête | bthxddi.h |
| IRQL | <= DISPATCH_LEVEL |