IOCTL_SBAUD_GET_MUTEPROPERTYVALUES IOCTL (sidebandaudio.h)

Article
02/26/2024

Le pilote audio peut appeler le IOCTL_SBAUD_GET_MUTEPROPERTYVALUES IOCTL pour interroger les plages de données pas à pas muet et les valeurs min/max pour tous les canaux. Ces valeurs doivent ensuite être retournées pour KSPROPERTY_AUDIO_MUTE prise en charge de base.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d'entrée

Valeur d’index de point de terminaison basée sur 0 en fonction du nombre de points de terminaison audio signalés par le IOCTL_SBAUD_GET_DEVICE_DESCRIPTOR. Il s’agit d’une valeur ULONG comprise entre 0 et (N-1), où N est le nombre de points de terminaison pour l’appareil.

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

Taille de ULONG.

Mémoire tampon de sortie

KSPROPERTY_DESCRIPTION suivis de plages de données pas à pas KSPROPERTY_MEMBERSHEADER et Muet, comme indiqué dans KSPROPERTY_DESCRIPTION et KSPROPERTY_MEMBERSHEADER.

Si la valeur est NULL, Irp-IoStatus.Information> est défini sur le nombre d’octets requis pour la mémoire tampon de sortie.

Longueur de la mémoire tampon de sortie

Taille de KSPROPERTY_DESCRIPTION en plus de toutes les plages de KSPROPERTY_MEMBERSHEADER et d’étapes. Cette taille est retournée dans SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR. MutePropertyValuesSize.

Bloc d’état

Irp-IoStatus.Status> est défini sur STATUS_SUCCESS si la demande réussit ; sinon, status à la condition d’erreur appropriée en tant que code NTSTATUS.

Si la mémoire tampon de sortie a la valeur NULL, Irp-IoStatus.Status> est défini sur STATUS_BUFFER_TOO_SMALL et Irp-IoStatus.Information> est défini sur le nombre d’octets requis pour la mémoire tampon de sortie.

Si la mémoire tampon de sortie correctement dimensionnée est fournie, Irp-IoStatus.Information> est défini sur le nombre d’octets écrits dans la mémoire tampon de sortie.

Pour plus d’informations, consultez Valeurs NTSTATUS.

Remarques

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

Les pilotes audio qui implémentent l’audio en bande latérale doivent publier le son du point de terminaison muet via un nœud muet dans leur filtre KS ou via le nœud du moteur audio. Les deux méthodes peuvent utiliser les informations de support de base fournies par ce IOCTL.