Partager via


IOCTL_SBAUD_GET_VOLUME_STATUS_UPDATE IOCTL (sidebandaudio.h)

Le IOCTL_SBAUD_GET_VOLUME_STATUS_UPDATE IOCTL obtient le paramètre de niveau de volume du point de terminaison audio de bande latérale.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d'entrée

SIDEBANDAUDIO_VOLUME_PARAMS structure avec l’index de point de terminaison basé sur 0 et le numéro de canal, ainsi que le paramètre « immédiat » indiquant s’il faut traiter immédiatement ce IOCTL ou l’annuler pour les mises à jour futures.

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

Taille de SIDEBANDAUDIO_VOLUME_PARAMS.

Mémoire tampon de sortie

SIDEBANDAUDIO_VOLUME_PARAMS.

Longueur de la mémoire tampon de sortie

Taille de SIDEBANDAUDIO_VOLUME_PARAMS.

Bloc d’état

Irp-IoStatus.Status> a la valeur STATUS_SUCCESS si la demande réussit. Sinon, indiquez la condition d’erreur appropriée en tant que code NTSTATUS. Pour plus d’informations, consultez Valeurs NTSTATUS.

Remarques

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

La mise à jour du volume IOCTL peut être utilisée dans deux modes : mise à jour et immédiate. Si SIDEBANDAUDIO_VOLUME_PARAMS::Immediate le paramètre a la valeur TRUE, iocTL retourne immédiatement avec la valeur de volume actuelle pour le canal demandé. Si le paramètre Immediate a la valeur FALSE, l’IRP est suspendu par le pilote audio de bande latérale (comme USB Audio) jusqu’à ce qu’il y ait une modification dans le volume de l’appareil. Le pilote audio doit configurer un volume IOCTL en attente pour être informé de toute modification du volume matériel.

Configuration requise

Condition requise Valeur
En-tête sidebandaudio.h

Voir aussi

SIDEBANDAUDIO_VOLUME_PARAMS

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

sidebandaudio.h