IOCTL_SBAUD_GET_MUTEPROPERTYVALUES IOCTL (sidebandaudio.h)

Articolo
07/22/2023

Il driver audio può chiamare il IOCTL_SBAUD_GET_MUTEPROPERTYVALUES IOCTL per eseguire una query su intervalli di dati con rientri disattivati 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 in base a 0 in base al numero di endpoint audio segnalati 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 KSPROPERTY_MEMBERSHEADER e Mute rientri 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 dello stato

Irp-IoStatus.Status> è impostato su STATUS_SUCCESS se la richiesta ha esito positivo; in caso contrario, lo stato viene impostato sulla 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.

Commenti

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

I driver audio che implementano l'audio sideband devono annunciare l'disattivazione dell'endpoint 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.