IChannelAudioVolume::GetChannelVolume-Methode (audioclient.h)

Artikel
08/22/2023

Die GetChannelVolume-Methode ruft die Lautstärkeebene für den angegebenen Kanal in der Audiositzung ab.

Syntax

HRESULT GetChannelVolume(
  [in]  UINT32 dwIndex,
  [out] float  *pfLevel
);

Parameter

[in] dwIndex

Die Kanalnummer. Wenn das Streamformat für die Audiositzung über N-Kanäle verfügt, werden die Kanäle von 0 bis N– 1 nummeriert. Um die Anzahl der Kanäle abzurufen, rufen Sie die IChannelAudioVolume::GetChannelCount-Methode auf.

[out] pfLevel

Zeiger auf eine float-Variable , in die die -Methode die Volumeebene des angegebenen Kanals schreibt. Die Volumeebene liegt 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 dwIndex ist auf eine ungültige Kanalnummer festgelegt.
E_POINTER	Der Parameter pfLevel 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

Share via