IChannelAudioVolume::GetChannelVolume-Methode (audioclient.h)
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 |
|---|---|
|
Der Parameter dwIndex ist auf eine ungültige Kanalnummer festgelegt. |
|
Der Parameter pfLevel 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
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