Freigeben über


KSPROPERTY_AUDIO_VOLUMELEVEL

Die KSPROPERTY_AUDIO_VOLUMELEVEL-Eigenschaft gibt die Volumeebene eines Kanals in einem Volumeknoten (KSNODETYPE_VOLUME) an.

Nutzungszusammenfassungstabelle

Herunterladen Set Ziel Eigenschaftsdeskriptortyp Eigenschaftswerttyp

Ja

Ja

Knoten über Filter oder Anheften instance

KSNODEPROPERTY_AUDIO_CHANNEL

LONG

Der Eigenschaftswert ist vom Typ LONG und gibt die Volumeebene eines Kanals in einem bestimmten Stream an. Für Werte auf Volumeebene wird die folgende Skalierung verwendet:

-2147483648 ist -unendliche Dezibel (Dämpfung),

-2147483647 ist -32767.99998474 Dezibel (Dämpfung), und

+2147483647 ist +32767,99998474 Dezibel (Verstärkung).

Hinweis

 Der Dezibelbereich wird durch ganzzahlige Werte von -2147483648 bis +2147483647 dargestellt, wobei diese Skala eine Auflösung von 1/65536 Dezibel aufweist.

Wenn ein Wert außerhalb des Bereichs des Filters angegeben wird, ist die Anforderung zum Festlegen dieser Eigenschaft weiterhin erfolgreich. Der tatsächliche Wert, der auf den Filter angewendet wurde, kann jedoch nur durch einen nachfolgenden Get-Aufruf dieser Eigenschaft bestimmt werden.

Rückgabewert

Eine KSPROPERTY_AUDIO_VOLUMELEVEL-Eigenschaftsanforderung gibt STATUS_SUCCESS zurück, um anzugeben, dass sie erfolgreich abgeschlossen wurde. Andernfalls gibt die Anforderung einen entsprechenden Fehler status Code zurück.

Bemerkungen

Der Eigenschaftsdeskriptor für diese Eigenschaft gibt eine Kanalnummer an. Wenn der Stream, der den Volumeknoten durchläuft, n Kanäle enthält, sind die Kanäle 0 bis n-1 nummeriert. Weitere Informationen finden Sie unter Verfügbarmachen von Mehrkanalknoten.

Anforderungen

Header

Ksmedia.h (include Ksmedia.h)

Siehe auch

Anpassen der Standardlautstärkeeinstellungen

Standardeinstellungen für Die Audiolautstärke

KSNODEPROPERTY_AUDIO_CHANNEL

KSNODETYPE_VOLUME