IAudioSessionControl::GetGroupingParam-Methode (audiopolicy.h)
Die GetGroupingParam-Methode ruft den Gruppierungsparameter der Audiositzung ab.
Syntax
HRESULT GetGroupingParam(
[out] GUID *pRetVal
);
Parameter
[out] pRetVal
Ausgabezeiger für die Gruppierungsparameter-GUID. Dieser Parameter muss ein gültiger Nicht-NULL-Zeiger auf eine vom Aufrufer zugewiesene GUID-Variable sein. Die -Methode schreibt den Gruppierungsparameter in diese Variable.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Parameter pRetVal ist NULL. |
|
Das Audioendpunktgerät wurde getrennt, oder die Audiohardware oder die zugehörigen Hardwareressourcen wurden neu konfiguriert, deaktiviert, entfernt oder anderweitig für die Verwendung nicht verfügbar gemacht. |
|
Der Windows-Audiodienst wird nicht ausgeführt. |
Hinweise
Alle Audiositzungen, die denselben Gruppierungsparameterwert aufweisen, stehen unter der Kontrolle desselben Schiebereglers auf Lautstärkeebene im Systemvolumeprogramm Sndvol. Weitere Informationen finden Sie unter Gruppierungsparameter.
Ein Client kann die IAudioSessionControl::SetGroupingParam-Methode aufrufen, um den Gruppierungsparameter einer Sitzung zu ändern.
Wenn ein Client noch nie SetGroupingParam aufgerufen hat, um einer Audiositzung einen Gruppierungsparameter zuzuweisen, wird der Gruppierungsparameterwert der Sitzung standardmäßig GUID_NULL, und ein Aufruf von GetGroupingParam ruft diesen Wert ab. Ein Gruppierungsparameterwert von GUID_NULL gibt an, dass die Sitzung keiner Gruppierung angehört. In diesem Fall verfügt die Sitzung über einen eigenen Schieberegler auf Volumeebene im Sndvol-Programm.
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 |