IOCTL_SBAUD_GET_DEVICE_DESCRIPTOR IOCTL (sidebandaudio.h)
Le pilote audio émet le IOCTL_SBAUD_GET_DEVICE_DESCRIPTOR pour obtenir des informations sur une interface de périphérique audio bande latérale activée. Plus précisément, cela retourne le nombre de points de terminaison audio disponibles sur un appareil qui prend en charge la bande latérale. Ces informations sont retournées dans une structure de descripteur de périphérique audio .
Code principal
Mémoire tampon d'entrée
NULL.
Longueur de la mémoire tampon d’entrée
Mémoire tampon de sortie
Mémoire tampon contenant une structure SIDEBANDAUDIO_DEVICE_DESCRIPTOR .
Longueur de la mémoire tampon de sortie
Taille d’une structure de SIDEBANDAUDIO_DEVICE_DESCRIPTOR .
Bloc d’état
Si la routine réussit, Status est défini sur STATUS_SUCCESS et le membre Information est le nombre d’octets que la routine écrit dans la mémoire tampon de sortie.
Si Status est défini sur STATUS_BUFFER_TOO_SMALL, le pilote audio doit lire le membre Information pour obtenir la taille de la mémoire tampon que l’appelant doit allouer pour cette demande.
Remarques
Cet IOCTL ne peut être appelé qu’à partir du mode noyau.
Le pilote audio envoie cette requête pour obtenir des informations sur une interface de périphérique bande latérale Audio activée. Les informations ne changent pas tant que l’interface est activée, mais peuvent changer lorsque l’interface est désactivée. Le pilote audio envoie cette requête peu après avoir découvert une interface de périphérique audio en bande latérale activée et utilise les informations pour déterminer le nombre de points de terminaison audio de bande latérale disponibles.
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 définit le membre Information 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 de périphérique à des fins de référence lors d’une activité ultérieure.
Le pilote audio peut ensuite déterminer de manière itérative chaque fonctionnalité de point de terminaison avec le IOCTL_SBAUD_GET_ENDPOINT_DESCRIPTOR IOCTL.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | sidebandaudio.h |