IAudioSessionControl::SetGroupingParam-Methode (audiopolicy.h)

Die SetGroupingParam-Methode weist einer Gruppierung von Sitzungen eine Sitzung zu.

Syntax

HRESULT SetGroupingParam(
  [in] LPCGUID Override,
  [in] LPCGUID EventContext
);

Parameter

[in] Override

Der neue Gruppierungsparameter. Dieser Parameter muss ein gültiger Nicht-NULL-Zeiger auf eine Grouping-Parameter-GUID sein. Weitere Informationen finden Sie in den Hinweisen.

[in] EventContext

Zeiger auf die Ereigniskontext-GUID. Wenn ein Aufruf dieser Methode ein Gruppierungsänderungsereignis generiert, sendet der Sitzungs-Manager Benachrichtigungen an alle Clients, die IAudioSessionEvents-Schnittstellen mit dem Sitzungs-Manager registriert haben. Der Sitzungs-Manager enthält den EventContext-Zeigerwert mit jeder Benachrichtigung. Beim Empfang einer Benachrichtigung kann ein Client ermitteln, ob er oder ein anderer Client die Quelle des Ereignisses ist, indem er den EventContext-Wert überprüft. Dieses Schema hängt davon ab, dass der Client einen Wert für diesen Parameter auswählt, der für alle Clients in der Sitzung eindeutig 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, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.

Rückgabecode	Beschreibung
E_POINTER	Die Parametergruppierung ist NULL.
AUDCLNT_E_DEVICE_INVALIDATED	Das Audioendpunktgerät wurde nicht angeschlossen, oder die Audiohardware oder die zugehörigen Hardwareressourcen wurden neu konfiguriert, deaktiviert, entfernt oder anderweitig nicht mehr verfügbar gemacht.
AUDCLNT_E_SERVICE_NOT_RUNNING	Der Windows-Audiodienst wird nicht ausgeführt.

Hinweise

Ein Client ruft diese Methode auf, um den Gruppierungsparameter einer Sitzung zu ändern. Alle Audiositzungen, die über denselben Gruppierungsparameterwert verfügen, befinden sich unter der Kontrolle desselben Schiebereglers auf Lautstärkeebene im Sndvolume-Programm des Systems. Weitere Informationen finden Sie unter Gruppierungsparameter.

Der Client kann den aktuellen Gruppierungsparameter für die Sitzung abrufen, indem er die IAudioSessionControl::GetGroupingParam-Methode aufruft .

Wenn ein Client noch nie SetGroupingParam aufgerufen hat, um einer Sitzung einen Gruppierungsparameter zuzuweisen, gehört die Sitzung keiner Gruppierung an. Eine Sitzung, die keiner Gruppierung angehört, verfügt über einen eigenen, dedizierten Schieberegler auf Volumeebene im Sndvol-Programm.

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	audiopolicy.h

Weitere Informationen

IAudioSessionControl-Schnittstelle

IAudioSessionControl::GetGroupingParam

IAudioSessionEvents-Schnittstelle