IAudioSessionEvents::OnGroupingParamChanged-Methode (audiopolicy.h)
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 |