IOCTL_SBAUD_GET_MUTEPROPERTYVALUES IOCTL (sidebandaudio.h)

Article
02/07/2025

Le pilote audio peut appeler le IOCTL_SBAUD_GET_MUTEPROPERTYVALUES IOCTL pour interroger les plages de données pas à pas 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 correspond au nombre de points de terminaison de l’appareil.

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

Taille de ULONG.

Mémoire tampon de sortie

KSPROPERTY_DESCRIPTION suivis des plages de données pas à pas KSPROPERTY_MEMBERSHEADER et muet, comme documentés dans KSPROPERTY_DESCRIPTION et KSPROPERTY_MEMBERSHEADER.

Si 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 d’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 requête réussit, sinon, État à 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

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

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