IAudioPeakMeter::GetLevel-Methode (devicetopology.h)

  • Artikel

Die GetLevel-Methode ruft die Spitzenebene ab, die der Spitzenzähler für den angegebenen Kanal aufgezeichnet hat, da die Spitzenebene für diesen Kanal zuvor gelesen wurde.

Syntax

HRESULT GetLevel(
  [in]  UINT  nChannel,
  [out] float *pfLevel
);

Parameter

[in] nChannel

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

[out] pfLevel

Zeiger auf eine float-Variable , in die die -Methode den Spitzenzählerstand in Dezibel schreibt.

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_INVALIDARG
 Parameter nChannel liegt außerhalb des Bereichs.
E_POINTER
 Der Zeiger pfLevel ist NULL.

Anforderungen

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

Weitere Informationen

IAudioPeakMeter-Schnittstelle

IAudioPeakMeter::GetChannelCount