IOCTL_SBAUD_GET_MUTEPROPERTYVALUES IOCTL (sidebandaudio.h)

Artikel
02/29/2024

Der Audiotreiber kann die IOCTL_SBAUD_GET_MUTEPROPERTYVALUES IOCTL aufrufen, um die stummgeschalteten abgestuften Datenbereiche und die Min/Max-Werte für alle Kanäle abzufragen. Diese Werte sollten dann für KSPROPERTY_AUDIO_MUTE grundlegenden Support zurückgegeben werden.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Ein 0-basierter Endpunktindexwert, der auf der Anzahl der Audioendpunkte basiert, die vom IOCTL_SBAUD_GET_DEVICE_DESCRIPTOR gemeldet werden. Dies ist ein ULONG-Wert von 0 bis (N-1), wobei N die Anzahl der Endpunkte für das Gerät ist.

Eingabepufferlänge

Größe von ULONG.

Ausgabepuffer

KSPROPERTY_DESCRIPTION gefolgt von KSPROPERTY_MEMBERSHEADER und Stummschalten gestuften Datenbereichen, wie in KSPROPERTY_DESCRIPTION und KSPROPERTY_MEMBERSHEADER dokumentiert.

Bei NULL wird Irp-IoStatus.Information> auf die Anzahl der Bytes festgelegt, die für den Ausgabepuffer erforderlich sind.

Länge des Ausgabepuffers

Größe von KSPROPERTY_DESCRIPTION zusätzlich zu allen KSPROPERTY_MEMBERSHEADER- und Schrittbereichen. Diese Größe wird in SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR zurückgegeben. MutePropertyValuesSize.

Statusblock

Irp-IoStatus.Status> wird auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist, andernfalls Status auf die entsprechende Fehlerbedingung als NTSTATUS-Code.

Wenn der Ausgabepuffer NULL ist, wird Irp-IoStatus.Status> auf STATUS_BUFFER_TOO_SMALL und Irp-IoStatus.Information> auf die Anzahl von Bytes festgelegt, die für den Ausgabepuffer erforderlich sind.

Wenn der Ausgabepuffer ordnungsgemäß dimensioniert wird, wird Irp-IoStatus.Information> auf die Anzahl der In den Ausgabepuffer geschriebenen Bytes festgelegt.

Weitere Informationen finden Sie unter NTSTATUS-Werte.

Hinweise

Diese IOCTL kann nur im Kernelmodus aufgerufen werden.

Audiotreiber, die Seitenbandaudio implementieren, sollten den Endpunkt Stummschaltung über einen Stummschaltknoten in ihrem KS-Filter oder über den Audiomodulknoten ankündigen. Beide Methoden können die grundlegenden Supportinformationen nutzen, die von dieser IOCTL bereitgestellt werden.