KSPROPERTY_AUDIO_VOLUMELEVEL

Artikel
06/14/2023

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.