Поделиться через

KSPROPERTY_AUDIO_FILTER_STATE

  • Статья

Свойство KSPROPERTY_AUDIO_FILTER_STATE используется для запроса фильтра GFX списка поддерживаемых наборов свойств. Список извлекается в виде массива идентификаторов GUID набора свойств.

Сводная таблица использования

Получить Присвойте параметру Назначение Тип дескриптора свойства Тип значения свойства

Да

Нет

Фильтр

KSPROPERTY

Массив идентификаторов GUID

Данные свойства (данные операции) — это массив идентификаторов GUID. Каждый GUID в массиве указывает набор свойств, поддерживаемый фильтром.

Возвращаемое значение

Запрос свойства KSPROPERTY_AUDIO_FILTER_STATE возвращает STATUS_SUCCESS, указывающий на успешное завершение. В противном случае запрос возвращает соответствующий код состояния ошибки.

Комментарии

Размер массива идентификаторов GUID, возвращаемых этим свойством, зависит от количества наборов свойств, поддерживаемых фильтром. Перед получением массива клиент сначала запрашивает размер массива GUID свойства, отправляя обработчик свойств драйвера мини-порта KSPROPERTY_AUDIO_FILTER_STATE запрос get-property с буфером свойства нулевой длины. Обработчик отвечает, возвращая требуемый размер буфера и код состояния STATUS_BUFFER_OVERFLOW. Дополнительные сведения см. в разделе Обработчики свойств аудио.

С помощью массива GUID из KSPROPERTY_AUDIO_FILTER_STATE запроса get-property операционная система может последовательно запрашивать свойства в каждом наборе свойств. Эти сведения позволяют операционной системе восстановить состояние объекта фильтра GFX во время создания экземпляра фильтра, а также сохранить состояние объекта фильтра GFX во время его уничтожения. При сохранении или восстановлении состояния фильтра GFX операционная система сериализует свои запросы для свойств в каждом наборе свойств, как описано в разделе Свойства KS. Целью сохранения и восстановления состояния фильтра GFX является сохранение всех изменений, внесенных пользователем в параметры фильтра, а также сохранение параметров в последующих экземплярах фильтра. .

Требования

Заголовок

 Ksmedia.h (включая Ksmedia.h)

См. также

KSPROPERTY