IAudioSessionEvents::OnSimpleVolumeChanged-Methode (audiopolicy.h)

  • Artikel

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

ISimpleAudioVolume::SetMasterVolume

ISimpleAudioVolume::SetMute