IAudioStreamVolume::SetAllVolumes-Methode (audioclient.h)
Die SetAllVolumes-Methode legt die einzelnen Lautstärkestufen für alle Kanäle im Audiostream fest.
Syntax
HRESULT SetAllVolumes(
[in] UINT32 dwCount,
[in] const float *pfVolumes
);
Parameter
[in] dwCount
Die Anzahl der Elemente im PfVolumes-Array . Dieser Parameter muss der Anzahl von Kanälen im Streamformat entsprechen. Rufen Sie die IAudioStreamVolume::GetChannelCount-Methode auf, um die Anzahl der Kanäle abzurufen.
[in] pfVolumes
Zeiger auf ein Array von Lautstärkepegeln für die Kanäle im Audiostream. Die Anzahl der Elemente im pfVolumes-Array wird durch den dwCount-Parameter angegeben. Der Aufrufer schreibt die Volumeebene für jeden Kanal in das Arrayelement, dessen Index mit der Kanalnummer übereinstimmt. Wenn das Streamformat über N-Kanäle verfügt, werden die Kanäle von 0 bis N– 1 nummeriert. 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, 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 dwCount entspricht nicht der Anzahl von Kanälen im Stream, oder der Wert eines pfVolumes-Arrayelements liegt nicht im Bereich von 0,0 bis 1,0. |
|
Der Parameter pfVolumes 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. |
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 |