Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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