IOCTL_SBAUD_GET_MUTE_STATUS_UPDATE IOCTL (sidebandaudio.h)

The IOCTL_SBAUD_GET_MUTE_STATUS_UPDATE IOCTL gets the mute level setting of the sideband audio endpoint.

Major code

IRP_MJ_DEVICE_CONTROL

Input buffer

SIDEBANDAUDIO_MUTE_PARAMS with the 0 based endpoint index and channel number along with 'immediate' parameter indicating whether to process this IOCTL immediately or pend it for future updates.

Input buffer length

Size of SIDEBANDAUDIO_MUTE_PARAMS.

Output buffer

SIDEBANDAUDIO_MUTE_PARAMS

Output buffer length

Size of SIDEBANDAUDIO_MUTE_PARAMS.

Status block

Irp->IoStatus.Status is set to STATUS_SUCCESS if the request is successful. Otherwise, Status to the appropriate error condition as a NTSTATUS code. For more information, see NTSTATUS Values.

Remarks

This IOCTL can only be called from kernel mode.

The mute update IOCTL can be used in two modes - update and immediate. If Immediate parameter is set to TRUE, the IOCTL returns immediately with the current mute value for the requested channel. If the Immediate parameter is set to FALSE, the IRP is pended by the sideband audio Driver until there is a change in the device mute state. Audio driver should setup a pending mute IOCTL to get notified of any changes in hardware mute state.

Requirements

Requirement Value
Header sidebandaudio.h

See also

SIDEBANDAUDIO_MUTE_PARAMS

Introduction to I/O Control Codes

sidebandaudio.h