IOCTL_SBAUD_GET_MUTEPROPERTYVALUES IOCTL (sidebandaudio.h)

Articolo
02/07/2025

Il driver audio può chiamare il IOCTL_SBAUD_GET_MUTEPROPERTYVALUES IOCTL per eseguire una query su intervalli di dati con rientri e valori min/max per tutti i canali. Questi valori devono quindi essere restituiti per KSPROPERTY_AUDIO_MUTE supporto di base.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Valore dell'indice dell'endpoint basato su 0 in base al numero di endpoint audio come segnalato dal IOCTL_SBAUD_GET_DEVICE_DESCRIPTOR. Si tratta di un valore ULONG compreso tra 0 e (N-1), dove N è il numero di endpoint per il dispositivo.

Lunghezza del buffer di input

Dimensioni di ULONG.

Buffer di output

KSPROPERTY_DESCRIPTION seguito da intervalli di dati di KSPROPERTY_MEMBERSHEADER e Mute come documentato in KSPROPERTY_DESCRIPTION e KSPROPERTY_MEMBERSHEADER.

Se NULL, Irp->IoStatus.Information verrà impostato sul numero di byte necessari per il buffer di output.

Lunghezza del buffer di output

Dimensioni di KSPROPERTY_DESCRIPTION oltre a tutti gli intervalli di passaggi e KSPROPERTY_MEMBERSHEADER. Questa dimensione viene restituita in SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR. MutePropertyValuesSize.

Blocco di stato

Irp->IoStatus.Status è impostato su STATUS_SUCCESS se la richiesta ha esito positivo; in caso contrario, stato alla condizione di errore appropriata come codice NTSTATUS.

Se il buffer di output è NULL, Irp->IoStatus.Status è impostato su STATUS_BUFFER_TOO_SMALL e Irp->IoStatus.Information viene impostato sul numero di byte necessari per il buffer di output.

Se viene fornito un buffer di output con dimensioni appropriate, Irp->IoStatus.Information viene impostato sul numero di byte scritti nel buffer di output.

Per altre informazioni, vedere valori NTSTATUS.

Osservazioni

Questo IOCTL può essere chiamato solo dalla modalità kernel.

I driver audio che implementano l'audio sideband devono annunciare l'audio disattivato tramite un nodo disattivato nel filtro KS o tramite il nodo del motore audio. Entrambi i metodi possono utilizzare le informazioni di supporto di base fornite da questo IOCTL.