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 |
|---|---|
|
Die Parametergruppierung ist NULL. |
|
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. |
|
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