IAudioStreamVolume::GetAllVolumes-Methode (audioclient.h)

Die GetAllVolumes-Methode ruft die Lautstärkepegel für alle Kanäle im Audiodatenstrom ab.

Syntax

HRESULT GetAllVolumes(
  [in]  UINT32 dwCount,
  [out] float  *pfVolumes
);

Parameter

[in] dwCount

Die Anzahl der Elemente im pfVolumes-Array . Der dwCount-Parameter muss der Anzahl von Kanälen im Streamformat entsprechen. Rufen Sie die IAudioStreamVolume::GetChannelCount-Methode auf, um die Anzahl der Kanäle abzurufen.

[out] pfVolumes

Zeiger auf ein Array von Lautstärkestufen für die Kanäle im Audiodatenstrom. Dieser Parameter verweist auf ein vom Aufrufer zugeordnetes Floatarray , in das die -Methode die Volumeebenen für die einzelnen Kanäle schreibt. Die Lautstärken 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 DwCount-Parameter entspricht nicht der Anzahl von Kanälen im Stream.
E_POINTER	Der Parameter pfVolumes ist NULL.
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.

Hinweise

Clients können die IAudioStreamVolume::SetAllVolumes - oder IAudioStreamVolume::SetChannelVolume-Methode aufrufen, um die Lautstärkepegel pro Kanal in einem Audiodatenstrom festzulegen.

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

IAudioStreamVolume::SetAllVolumes

IAudioStreamVolume::SetChannelVolume