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

KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED

  • Статья

KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED — это новое свойство KS, которое было добавлено в свойство KSPROPSETID_Audio, заданное в Windows 8.1.

Запрос свойства KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED передает пользователю предпочтение ограничения на уровне тома базовому драйверу. Область этого свойства — за pin (или на конечную точку звука, с точки зрения конечного пользователя).

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

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

Нет

Да

Экземпляр закрепления

KSP_PIN

BOOL

Значение свойства имеет тип BOOL и указывает, допускает ли конечный пользователь превышение максимального объема. Значение TRUE указывает, что конечный пользователь допустил превышение предельного объема, в то время как значение FALSE указывает на обратное. В случае с дочерней учетной записью всегда будет значение FALSE.

Драйвер сохраняет значение этого свойства во внутренней переменной и инициализирует значение TRUE во время запуска. Хотя это свойство имеет значение TRUE, драйвер ограничивает максимальный уровень громкости. Если для свойства задано значение FALSE, драйвер может снять эти ограничения.

Драйвер также может автоматически изменять значение этого свойства. Например, драйвер может автоматически переключить значение свойства с TRUE на FALSE, а затем начать ограничивать уровень громкости по истечении определенного времени.

При изменении значения свойства независимо от того, является ли оно автоматическим или из-за того, что вызывающий объект задает значение свойства, драйвер должен создать событие KSEVENT_PINCAPS_VOLUMELIMITCHANGE.

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

Запрос свойства KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED возвращает STATUS_SUCCESS при успешном выполнении запроса.

Требования

Версия

Windows 8.1

Заголовок

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