IChannelAudioVolume::GetAllVolumes-Methode (audioclient.h)

  • Artikel

Die GetAllVolumes-Methode ruft die Lautstärkepegel für alle Kanäle in der Audiositzung ab.

Syntax

HRESULT GetAllVolumes(
  [in]  UINT32 dwCount,
  [out] float  *pfVolumes
);

Parameter

[in] dwCount

Die Anzahl der Elemente im PfVolumes-Array . Der dwCount-Parameter muss der Anzahl von Kanälen im Streamformat für die Audiositzung entsprechen. Um die Anzahl der Kanäle abzurufen, rufen Sie die IChannelAudioVolume::GetChannelCount-Methode auf.

[out] pfVolumes

Zeiger auf ein Array von Lautstärkepegeln für die Kanäle in der Audiositzung. Dieser Parameter verweist auf ein vom Aufrufer zugewiesenes Floatarray , in das die -Methode die Volumeebenen für die einzelnen Kanäle schreibt. Die Lautstärkestufen liegen im Bereich von 0,0 bis 1,0.

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_INVALIDARG
 Der Parameter dwCount entspricht nicht der Anzahl von Kanälen im Streamformat für die Audiositzung.
E_POINTER
 Der Parameter pfVolumes 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

Clients können die IChannelAudioVolume::SetAllVolumes-Methode oder IChannelAudioVolume::SetChannelVolume-Methode aufrufen, um die Lautstärkepegel pro Kanal in einer Audiositzung festzulegen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile audioclient.h

Weitere Informationen

IChannelAudioVolume-Schnittstelle

IChannelAudioVolume::GetChannelCount

IChannelAudioVolume::SetAllVolumes

IChannelAudioVolume::SetChannelVolume