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. En particulier, 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

IRP_MJ_DEVICE_CONTROL

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 SIDEBANDAUDIO_DEVICE_DESCRIPTOR .

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.

Si l’état 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

Ce IOCTL ne peut être appelé qu’à partir du mode noyau.

Le pilote audio envoie cette demande pour obtenir des informations sur une interface de périphérique à bande latérale Audio activée. Les informations ne changent pas lorsque 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 à bande latérale activée et utilise les informations pour déterminer le nombre de points de terminaison audio à 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 d’appareil à 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

Voir aussi

sidebandaudio.h

Présentation des codes de contrôle d’E/S