IAudioEndpointVolume::GetChannelVolumeLevel-Methode (endpointvolume.h)

  • Artikel

Die GetChannelVolumeLevel-Methode ruft die Lautstärke des angegebenen Kanals im Audiodatenstrom in Dezibel ab, der in das Audioendpunktgerät eintritt oder dieses verlässt.

Syntax

HRESULT GetChannelVolumeLevel(
  [in]  UINT  nChannel,
  [out] float *pfLevelDB
);

Parameter

[in] nChannel

Die Kanalnummer. Wenn der Audiodatenstrom über n Kanäle verfügt, werden die Kanäle von 0 bis n bis 1 nummeriert. Rufen Sie die IAudioEndpointVolume::GetChannelCount-Methode auf, um die Anzahl der Kanäle im Stream abzurufen.

[out] pfLevelDB

Zeiger auf eine float-Variable , in die die -Methode die Lautstärkeebene in Dezibel schreibt. Rufen Sie die IAudioEndpointVolume::GetVolumeRange-Methode auf, um den Bereich der Volumeebenen abzurufen, die von dieser Methode abgerufen werden.

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 Parameter nChannel ist größer oder gleich der Anzahl der Kanäle im Stream.
E_POINTER
 Der Parameter pfLevelDB ist NULL.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile endpointvolume.h

Weitere Informationen

IAudioEndpointVolume-Schnittstelle

IAudioEndpointVolume::GetChannelCount

IAudioEndpointVolume::GetVolumeRange