IAudioStreamVolume::SetChannelVolume-Methode (audioclient.h)
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 |
|---|---|
|
Der Parameter dwIndex ist auf eine ungültige Kanalnummer festgelegt, oder der Parameter fLevel liegt nicht im Bereich von 0,0 bis 1,0. |
|
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. |
|
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 |