IAudioStreamVolume::SetAllVolumes-Methode (audioclient.h)

  • Artikel

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
E_INVALIDARG
 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.
E_POINTER
 Der Parameter pfVolumes ist NULL.
AUDCLNT_E_DEVICE_INVALIDATED
 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.
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