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 |
|---|---|
|
Der DwCount-Parameter entspricht nicht der Anzahl von Kanälen im Stream. |
|
Der Parameter pfVolumes ist NULL. |
|
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. |
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