IPerChannelDbLevel::GetLevelRange-Methode (devicetopology.h)

  • Artikel

Die GetLevelRange-Methode ruft den Bereich der Volumeebene des angegebenen Kanals in Dezibel ab.

Syntax

HRESULT GetLevelRange(
  [in]  UINT  nChannel,
  [out] float *pfMinLevelDB,
  [out] float *pfMaxLevelDB,
  [out] float *pfStepping
);

Parameter

[in] nChannel

Die Nummer des ausgewählten Kanals. 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 IPerChannelDbLevel::GetChannelCount-Methode auf.

[out] pfMinLevelDB

Zeiger auf eine float-Variable , in die die Methode die minimale Lautstärke in Dezibel schreibt.

[out] pfMaxLevelDB

Zeiger auf eine float-Variable , in die die Methode die maximale Lautstärke in Dezibel schreibt.

[out] pfStepping

Zeiger auf eine float-Variable , in die die Methode den Schrittwert zwischen aufeinanderfolgenden Volumeebenen im Bereich *pfMinLevelDB bis *pfMaxLevelDB schreibt. Wenn der Unterschied zwischen den maximalen und minimalen Lautstärkestufen d Dezibel beträgt und der Bereich in n Schritte (gleichmäßig große Intervalle) unterteilt ist, kann das Volumen n + 1 diskrete Ebenen aufweisen, und die Größe des Schritts zwischen aufeinanderfolgenden Ebenen ist d / n n 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_INVALIDARG
 Parameter nChannel liegt außerhalb des Bereichs.
E_POINTER
 Zeiger pfminLevelDB, pfmaxLevelDB oder pfmaxLevelDB ist NULL.

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 devicetopology.h

Weitere Informationen

IPerChannelDbLevel-Schnittstelle

IPerChannelDbLevel::GetChannelCount