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

IRP_MJ_DEVICE_CONTROL

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