IAudioSessionEvents::OnSimpleVolumeChanged-Methode (audiopolicy.h)
Die OnSimpleVolumeChanged-Methode benachrichtigt den Client, dass sich die Lautstärke oder der Stummschaltungszustand der Audiositzung geändert hat.
Syntax
HRESULT OnSimpleVolumeChanged(
[in] float NewVolume,
[in] BOOL NewMute,
[in] LPCGUID EventContext
);
Parameter
[in] NewVolume
Die neue Lautstärkestufe für die Audiositzung. Dieser Parameter ist ein Wert im Bereich von 0,0 bis 1,0, wobei 0,0 still und 1,0 für volle Lautstärke (keine Dämpfung) steht.
[in] NewMute
Der neue Stummschaltungszustand. Bei TRUE ist das Stummschalten aktiviert. Bei FALSE ist das Stummschalten deaktiviert.
[in] EventContext
Der Ereigniskontextwert. Dies ist der gleiche Wert, den der Aufrufer an ISimpleAudioVolume::SetMasterVolume oder ISimpleAudioVolume::SetMute in dem Aufruf übergeben hat, der die Volumeebene oder den Stummschaltungszustand der Sitzung geändert hat. Weitere Informationen finden Sie in den Hinweisen.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.
Hinweise
Der Sitzungs-Manager ruft diese Methode jedes Mal auf, wenn ein Aufruf der ISimpleAudioVolume::SetMasterVolume - oder ISimpleAudioVolume::SetMute-Methode die Volumeebene oder den Stummschaltungszustand der Sitzung ändert.
Der EventContext-Parameter stellt ein Mittel für einen Client bereit, um zwischen einer Volume- oder Stummschaltungsänderung, die er initiiert hat, und einer Änderung zu unterscheiden, die von einem anderen Client initiiert wurde. Beim Aufrufen der ISimpleAudioVolume::SetMasterVolume- oder ISimpleAudioVolume::SetMute-Methode übergibt ein Client einen EventContext-Parameterwert , den die Implementierung der OnSimpleVolumeChanged-Methode erkennen kann.
Ein Codebeispiel, das die Methoden in der IAudioSessionEvents-Schnittstelle implementiert, finden Sie unter Audiositzungsereignisse.
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 | audiopolicy.h |
Weitere Informationen
IAudioSessionEvents-Schnittstelle