IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL (bthhfpddi.h)
Le IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL obtient des informations descriptives sur l’appareil de profil mains libres (HFP) jumelé.
Ce IOCTL est disponible dans les systèmes d’exploitation Windows 8.1 et ultérieurs, et il remplace IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR.
Code principal
Mémoire tampon d'entrée
None
Longueur de la mémoire tampon d’entrée
None
Mémoire tampon de sortie
Mémoire tampon contenant une structure BTHHFP_DESCRIPTOR2 suivie de toutes les 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 demande 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_DESCRIPTOR2 .
Longueur de la mémoire tampon de sortie
Taille d’une structure BTHHFP_DESCRIPTOR2 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 Information correspond au nombre d’octets que la routine écrit dans la mémoire tampon de sortie. Notez que cela peut être supérieur à la taille de la structure BTHHFP_DESCRIPTOR2 , car la mémoire tampon de sortie peut contenir d’autres données référencées par la structure BTHHFP_DESCRIPTOR2 .
Si l’état est défini sur STATUS_BUFFER_TOO_SMALL, les informations correspondent à 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 de périphérique GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS activée. Les informations ne changent pas lorsque l’interface est activée, mais peuvent changer lorsque l’interface est désactivée. Par conséquent, le pilote audio envoie cette requête peu de temps après la découverte d’une interface de périphérique activée et utilise les informations pour créer 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 avec status STATUS_BUFFER_TOO_SMALL et le paramètre Information contient la taille de mémoire tampon requise. Le pilote audio alloue ensuite le stockage nécessaire et envoie à nouveau la demande. En règle générale, un pilote audio conserve un pointeur vers cet emplacement de stockage dans son contexte d’appareil pour référence lors d’une activité ultérieure.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8.1 |
| Serveur minimal pris en charge | Windows Server 2012 R2 |
| En-tête | bthhfpddi.h |