KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED

KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED ist eine neue KS-Eigenschaft, die der in Windows 8.1 festgelegten KSPROPSETID_Audio-Eigenschaft hinzugefügt wurde.

Die KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED-Eigenschaftsanforderung übergibt die Einstellung für die Volumeebene eines Endbenutzers an den zugrunde liegenden Treiber. Der Bereich dieser Eigenschaft ist pro Pin (oder pro Audioendpunkt aus Sicht eines Endbenutzers).

Nutzungszusammenfassungstabelle

Der Eigenschaftswert ist vom Typ BOOL und gibt an, ob ein Endbenutzer zulässt, dass die maximale Lautstärke einen bestimmten Grenzwert überschreitet. Der Wert TRUE gibt an, dass ein Endbenutzer zugelassen hat, dass die Lautstärke den bereitgestellten Grenzwert überschreitet, während FALSE das Gegenteil angibt. Im Fall eines untergeordneten Kontos ist der Wert immer FALSE.

Der Treiber speichert den Wert dieser Eigenschaft in einer internen Variablen und initialisiert den Wert während des Startvorgangs in TRUE. Obwohl diese Eigenschaft TRUE ist, schränkt der Treiber die maximale Lautstärke ein. Wenn die -Eigenschaft auf FALSE festgelegt ist, kann der Treiber diese Grenzwerte entfernen.

Der Treiber kann auch den Wert dieser Eigenschaft automatisch ändern. Beispielsweise kann der Treiber den Eigenschaftswert automatisch von TRUE in FALSE ändern und dann beginnen, den Lautstärkepegel zu begrenzen, nachdem einige Zeit über bestimmten Soundpegeln abgelaufen ist.

Immer wenn sich der Wert der Eigenschaft ändert, unabhängig davon, ob er automatisch erfolgt oder aufgrund eines Aufrufers, der den Eigenschaftswert festlegt, sollte der Treiber das KSEVENT_PINCAPS_VOLUMELIMITCHANGE-Ereignis generieren.

Rückgabewert

Die KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED-Eigenschaftsanforderung gibt STATUS_SUCCESS zurück, wenn die Anforderung erfolgreich ist.

Requirements (Anforderungen)