Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die GetAllVolumes-Methode ruft die Lautstärkepegel für alle Kanäle in der Audiositzung 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 für die Audiositzung entsprechen. Um die Anzahl der Kanäle abzurufen, rufen Sie die IChannelAudioVolume::GetChannelCount-Methode auf.
[out] pfVolumes
Zeiger auf ein Array von Lautstärkepegeln für die Kanäle in der Audiositzung. Dieser Parameter verweist auf ein vom Aufrufer zugewiesenes Floatarray , in das die -Methode die Volumeebenen für die einzelnen Kanäle schreibt. Die 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 Streamformat für die Audiositzung. |
|
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. |
Hinweise
Clients können die IChannelAudioVolume::SetAllVolumes-Methode oder IChannelAudioVolume::SetChannelVolume-Methode aufrufen, um die Lautstärkepegel pro Kanal in einer Audiositzung festzulegen.
Anforderungen
| 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
IChannelAudioVolume-Schnittstelle
IChannelAudioVolume::GetChannelCount