IAudioEndpointVolumeEx::GetVolumeRangeChannel-Methode (endpointvolume.h)

Artikel
08/23/2023

Die GetVolumeRangeChannel-Methode ruft den Volumebereich für einen angegebenen Kanal ab.

Syntax

HRESULT GetVolumeRangeChannel(
  [in]  UINT  iChannel,
  [out] float *pflVolumeMindB,
  [out] float *pflVolumeMaxdB,
  [out] float *pflVolumeIncrementdB
);

Parameter

[in] iChannel

Die Kanalnummer, für die der Volumebereich abgerufen werden soll. Wenn der Audiostream über n Kanäle verfügt, werden die Kanäle von 0 bis n– 1 nummeriert. Um die Anzahl der Kanäle im Stream abzurufen, rufen Sie die IAudioEndpointVolume::GetChannelCount-Methode auf.

[out] pflVolumeMindB

Empfängt die Mindestlautstärke für den Kanal in Dezibel.

[out] pflVolumeMaxdB

Empfängt die maximale Lautstärke für den Kanal in Dezibel.

[out] pflVolumeIncrementdB

Empfängt das Volume-Inkrement für den Kanal in Dezibel.

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_POINTER	Der Parameter pfLevelMinDB, pfLevelMaxDB oder pfVolumeIncrementDB ist NULL.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	endpointvolume.h

Weitere Informationen

IAudioEndpointVolumeEx

Share via