IAudioEndpointVolume::VolumeStepDown-Methode (endpointvolume.h)

Die VolumeStepDown-Methode verringert in einem Schritt die Lautstärke des Audiodatenstroms, der in das Audioendpunktgerät eintritt oder dieses verlässt.

Syntax

HRESULT VolumeStepDown(
  [in] LPCGUID pguidEventContext
);

Parameter

[in] pguidEventContext

Kontextwert für die IAudioEndpointVolumeCallback::OnNotify-Methode . Dieser Parameter verweist auf eine Ereigniskontext-GUID. Wenn der VolumeStepDown-Aufruf die Volumeebene des Endpunkts ändert, erhalten alle Clients, die IAudioEndpointVolumeCallback-Schnittstellen mit diesem Endpunkt registriert haben, Benachrichtigungen. Bei der Implementierung der OnNotify-Methode kann ein Client die Ereigniskontext-GUID überprüfen, um zu ermitteln, ob er oder ein anderer Client die Quelle des Volumeänderungsereignisses ist. Wenn der Aufrufer einen NULL-Zeiger für diesen Parameter bereitstellt, empfängt die Benachrichtigungsmethode des Clients einen NULL-Kontextzeiger .

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.

Rückgabecode	Beschreibung
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.

Hinweise

Um den aktuellen Volumeschritt und die Gesamtanzahl der Schritte im Volumebereich abzurufen, rufen Sie die IAudioEndpointVolume::GetVolumeStepInfo-Methode auf.

Wenn sich die Volumeebene bereits auf dem niedrigsten Schritt im Volumebereich befindet, hat der Aufruf von VolumeStepDown keine Auswirkung und gibt status Code S_OK zurück.

Aufeinanderfolgende Intervalle zwischen benachbarten Schritten stellen nicht notwendigerweise gleichmäßige Volumenschritte in linearer Signalamplitude oder Dezibel dar. In Windows Vista definiert VolumeStepDown die Beziehung des Schrittindexes zur Lautstärkeebene (Signalamplitude), um eine audioverknüngte Kurve zu sein. Beachten Sie, dass sich die Form der Kurve in zukünftigen Versionen von Windows ändern kann. Weitere Informationen zu Audioverknüngungskurven finden Sie unter Audioverknen von Lautstärkesteuerungen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	endpointvolume.h

Weitere Informationen

IAudioEndpointVolume-Schnittstelle

IAudioEndpointVolume::GetVolumeStepInfo

IAudioEndpointVolumeCallback-Schnittstelle

IAudioEndpointVolumeCallback::OnNotify