IOCTL_SBAUD_GET_MUTEPROPERTYVALUES IOCTL (sidebandaudio.h)

Статья
02/29/2024

Звуковой драйвер может вызвать IOCTL_SBAUD_GET_MUTEPROPERTYVALUES IOCTL, чтобы запросить диапазоны ступенчатых данных и значения min/max для всех каналов. Затем эти значения должны быть возвращены для KSPROPERTY_AUDIO_MUTE базовой поддержки.

Основной код

IRP_MJ_DEVICE_CONTROL

Входной буфер

Значение индекса конечной точки на основе 0, основанное на количестве конечных точек Аудио, как указано IOCTL_SBAUD_GET_DEVICE_DESCRIPTOR. Это значение ULONG от 0 до (N–1), где N — количество конечных точек для устройства.

Длина входного буфера

Размер ULONG.

Выходной буфер

KSPROPERTY_DESCRIPTION за ним следуют диапазоны данных с KSPROPERTY_MEMBERSHEADER и отключением звука, как описано в KSPROPERTY_DESCRIPTION и KSPROPERTY_MEMBERSHEADER.

Если задано значение NULL, для Irp-IoStatus.Information> будет задано количество байтов, необходимых для выходного буфера.

Длина выходного буфера

Размер KSPROPERTY_DESCRIPTION в дополнение ко всем KSPROPERTY_MEMBERSHEADER и диапазонам шагов. Этот размер возвращается в SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR. MutePropertyValuesSize.

Блок состояния

Irp-IoStatus.Status> имеет значение STATUS_SUCCESS, если запрос выполнен успешно. В противном случае — состояние соответствующего условия ошибки в виде кода NTSTATUS.

Если выходной буфер имеет значение NULL, Irp-IoStatus.Status> имеет значение STATUS_BUFFER_TOO_SMALL, а Irp-IoStatus.Information> — количество байтов, необходимых для выходного буфера.

Если указан буфер вывода правильного размера, для параметра Irp-IoStatus.Information> устанавливается число байтов, записанных в выходной буфер.

Дополнительные сведения см. в разделе Значения NTSTATUS.

Аудиодрайверы, реализующие боковой звук, должны объявлять конечную точку Отключить звук через узел отключения звука в фильтре KS или через узел обработчика звука. Оба метода могут использовать основные сведения о поддержке, предоставляемые этим IOCTL.