KSPROPERTY_AUDIOENGINE_VOLUMELEVEL

Die KSPROPERTY_AUDIOENGINE_VOLUMELEVEL-Eigenschaft gibt die Volumeebene eines Kanals in einem bestimmten Stream an.

Nutzungszusammenfassungstabelle

Herunterladen	Set	Ziel	Eigenschaftsdeskriptortyp	Eigenschaftswerttyp
Ja	Ja	Knoten über anheften instance	KSNODEPROPERTY_AUDIO_CHANNEL	LONG (für eine Get-Anforderung) und KSAUDIOENGINE_VOLUMELEVEL (für eine Set-Anforderung).

Für eine Get-Anforderung ist der Eigenschaftswert vom Typ LONG und gibt die Volumeebene eines Kanals in einem bestimmten Stream an. Werte auf Volumeebene verwenden die folgende Skalierung und können durch die Mindest- und Höchstwerte begrenzt werden, die in der Antwort "Basic Support" für diese Eigenschaft angegeben werden:

-2147483648 (0x80000000 hexadezimal oder LONG_MIN) ist -Infinity-Dezibel (Dämpfung),

-2147483647 (0x80000001 hexadezimal oder LONG_MIN + 1) ist -32767.99998474 Dezibel (Dämpfung), und

+2147483647 (0x7FFFFFFF hexadezimal oder LONG_MAX) ist +32767.99998474 Dezibel (Gain).

Hinweis

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

Bei einer Set-Anforderung ist der Eigenschaftswert vom Typ KSAUDIOENGINE_VOLUMELEVEL und gibt die gewünschte Volumeebene eines Kanals in einem bestimmten Datenstrom sowie einen Kurventyp und die Kurvendauer an, die beim Festlegen der Volumeebene angewendet werden sollen. 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

Die KSPROPERTY_AUDIOENGINE_SUPPORTEDDEVICEFORMATS-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 Eigenschaftendeskriptor für KSPROPERTY_AUDIOENGINE_VOLUMELEVEL gibt eine Kanalnummer an. Wenn der Stream, der den Audiomodulknoten durchläuft, n Kanäle enthält, sind die Kanäle 0 bis n-1 nummeriert. Beachten Sie außerdem, dass ein Kanalwert von 0xFFFFFFFF angibt, dass die Anforderung für alle Kanäle gilt. Wenn eine Eigenschaftsanforderung gestellt wird, während sich der Stream nicht im Ausführungszustand befindet, wird die Volumeebene sofort auf die angeforderte Ebene festgelegt. Wenn der Stream den Ausführungszustand verlässt, während eine Volumeebenenrampe ausgeführt wird, wird die Volumeebene des Datenstroms sofort auf die Zielebene der aktuellen Einstellung festgelegt. Wenn eine neue Eigenschaftsanforderung gestellt wird, während eine vorhandene Volumeebenenrampe ausgeführt wird, muss die neue Rampenanforderung mit der aktuellen Volumeebene beginnen – der Ebene, die das Volume erreicht hatte, als die neue Anforderung eintraf.

Requirements (Anforderungen)

Version	Windows 8
Header	Ksmedia.h

Siehe auch

KSAUDIOENGINE_VOLUMELEVEL

KSNODEPROPERTY_AUDIO_CHANNEL

KSPROPERTY_AUDIOENGINE

KSPROPERTY_AUDIOENGINE_SUPPORTEDDEVICEFORMATS