Share via

IAudioStreamVolume::SetChannelVolume-Methode (audioclient.h)

  • Artikel

Die SetChannelVolume-Methode legt die Lautstärke für den angegebenen Kanal im Audiodatenstrom fest.

Syntax

HRESULT SetChannelVolume(
  [in] UINT32      dwIndex,
  [in] const float fLevel
);

Parameter

[in] dwIndex

Die Kanalnummer. Wenn das Streamformat N-Kanäle aufweist, werden die Kanäle von 0 bis N – 1 nummeriert. Rufen Sie die IAudioStreamVolume::GetChannelCount-Methode auf, um die Anzahl der Kanäle abzurufen.

[in] fLevel

Die Lautstärkeebene für den Kanal. Gültige 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, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.

Rückgabecode Beschreibung
E_INVALIDARG
 Der Parameter dwIndex ist auf eine ungültige Kanalnummer festgelegt, oder der Parameter fLevel liegt nicht im Bereich von 0,0 bis 1,0.
AUDCLNT_E_DEVICE_INVALIDATED
 Das Audioendpunktgerät wurde nicht angeschlossen, oder die Audiohardware oder die zugehörigen Hardwareressourcen wurden neu konfiguriert, deaktiviert, entfernt oder anderweitig nicht mehr verfügbar gemacht.
AUDCLNT_E_SERVICE_NOT_RUNNING
 Der Windows-Audiodienst wird nicht ausgeführt.

Anforderungen

Anforderung Wert
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

IAudioStreamVolume-Schnittstelle

IAudioStreamVolume::GetChannelCount