IAudioSessionEvents::OnGroupingParamChanged-Methode (audiopolicy.h)

  • Artikel

Die OnGroupingParamChanged-Methode benachrichtigt den Client, dass der Gruppierungsparameter für die Sitzung geändert wurde.

Syntax

HRESULT OnGroupingParamChanged(
  [in] LPCGUID NewGroupingParam,
  [in] LPCGUID EventContext
);

Parameter

[in] NewGroupingParam

Der neue Gruppierungsparameter für die Sitzung. Dieser Parameter verweist auf eine Gruppierungsparameter-GUID.

[in] EventContext

Der Ereigniskontextwert. Dies ist der gleiche Wert, den der Aufrufer in dem Aufruf, der den Gruppierungsparameter für die Sitzung geändert hat, an IAudioSessionControl::SetGroupingParam übergeben 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 IAudioSessionControl::SetGroupingParam-Methode den Gruppierungsparameter für die Sitzung ändert.

Der EventContext-Parameter bietet ein Mittel für einen Client, um zwischen einer von diesem initiierten Gruppierungsparameteränderung und einer Änderung zu unterscheiden, die von einem anderen Client initiiert wurde. Beim Aufrufen der IAudioSessionControl::SetGroupingParam-Methode übergibt ein Client einen EventContext-Parameterwert , den seine Implementierung der OnGroupingParamChanged-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

IAudioSessionControl::SetGroupingParam

IAudioSessionEvents-Schnittstelle