IOCTL_BTHX_GET_VERSION IOCTL (bthxddi.h)

Les pilotes de profil utilisent IOCTL_BTHX_GET_VERSION pour obtenir la version prise en charge par le pilote de transport.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d'entrée

Aucun.

Longueur de la mémoire tampon d’entrée

Aucun.

Mémoire tampon de sortie

Les pilotes de profil doivent utiliser KMDF et sa méthode WdfRequestRetrieveOutputMemory pour récupérer les paramètres de sortie. Par exemple, pour obtenir la mémoire tampon de sortie :

Status = WdfRequestRetrieveOutputMemory(_Request, &ReqOutMemory);

La mémoire tampon décrit une structure BTHX_VERSION .

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 de la structure BTHX_VERSION .

Bloc d’état

Le membre Information de la structure STATUS_BLOCK est défini sur la taille, en octets, de la mémoire tampon qui contient la structure BTHX_VERSION.

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.

 

Tout code de status NT qui échoue empêche le chargement du pilote.

Remarques

IOCTL_BTHX_GET_VERSION est une opération synchrone.

Un pilote de transport peut retourner une ou plusieurs versions qu’il prend en charge dans BTHX_VERSION structure. Si aucune version n’est définie, Windows décharge la pile Bluetooth.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge à partir de Windows 8.
En-tête	bthxddi.h
IRQL	<= PASSIVE_LEVEL