IAudioEndpointVolume::VolumeStepUp-Methode (endpointvolume.h)
Die VolumeStepUp-Methode erhöht in einem Schritt die Lautstärke des Audiostreams, der in das Audioendpunktgerät eintritt oder dieses verlässt.
Syntax
HRESULT VolumeStepUp(
[in] LPCGUID pguidEventContext
);
Parameter
[in] pguidEventContext
Kontextwert für die IAudioEndpointVolumeCallback::OnNotify-Methode . Dieser Parameter verweist auf eine Ereigniskontext-GUID. Wenn der VolumeStepUp-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 |
|---|---|
|
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 höchsten Schritt im Volumebereich befindet, hat der Aufruf von VolumeStepUp 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 VolumeStepUp 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
| 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