IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR IOCTL (bthhfpddi.h)

Le pilote audio émet le code de contrôle IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR pour obtenir des informations sur une interface d’appareil GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS activée.

Remarque Ce IOCTL remplace IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES et IOCTL_BTHHFP_DEVICE_GET_CONTAINERID qui ont été dépréciés.

 

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

Mémoire tampon contenant une structure BTHHFP_DESCRIPTOR suivie d’autres données référencées par la structure. Cela est vrai, si la taille de la mémoire tampon de sortie est suffisante et que la requête réussit. En particulier, la mémoire tampon inclut le stockage de la chaîne référencée par le champ FriendlyName de la structure BTHHFP_DESCRIPTOR.

Longueur de la mémoire tampon de sortie

Taille d’une structure BTHHFP_DESCRIPTOR et des données référencées.

Bloc d’état

Si la routine réussit, l’état est défini sur STATUS_SUCCESS et le membre Informations est le nombre d’octets que la routine écrit dans la mémoire tampon de sortie.

Remarque Cela peut être supérieur à la taille de la structure BTHHFP_DESCRIPTOR, car la mémoire tampon de sortie peut contenir d’autres données référencées par la structure

 

Si l’état est défini sur STATUS_BUFFER_TOO_SMALL, le pilote audio doit lire le membre Informations pour obtenir la taille de la mémoire tampon que l’appelant doit allouer pour cette demande.

Remarques

Le pilote audio envoie cette demande pour obtenir des informations sur une interface d’appareil GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS activée. Les informations ne changent pas lorsque l’interface est activée, mais peuvent changer pendant la désactivation de l’interface. Par conséquent, le pilote audio envoie cette requête peu après avoir découvert une interface d’appareil activée et utilise les informations pour générer une structure de KSFILTER_DESCRIPTOR appropriée.

Le pilote audio envoie cette requête une fois avec une taille de mémoire tampon de sortie de zéro (0) afin de déterminer la taille de mémoire tampon de sortie requise. Dans ce cas, la demande se termine par status STATUS_BUFFER_TOO_SMALL et définit l'Informations membre sur la taille de mémoire tampon requise. Le pilote audio alloue ensuite l’espace de stockage nécessaire et envoie à nouveau la requête. En règle générale, un pilote audio stocke un pointeur vers cet emplacement de stockage dans son contexte d’appareil pour référence pendant l’activité ultérieure.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8
serveur minimum pris en charge	Windows Server 2012
d’en-tête	bthhfpddi.h

Voir aussi

bluetooth HFP DDI IOCTLs

IOCTL_BTHHFP_DEVICE_GET_CONTAINERID

IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES