IAudioSessionControl::GetGroupingParam-Methode (audiopolicy.h)

  • Artikel

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
E_POINTER
 Der Parameter pRetVal ist NULL.
AUDCLNT_E_DEVICE_INVALIDATED
 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.
AUDCLNT_E_SERVICE_NOT_RUNNING
 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

Weitere Informationen

IAudioSessionControl-Schnittstelle

IAudioSessionControl::SetGroupingParam