IPerChannelDbLevel::GetLevelRange-Methode (devicetopology.h)
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 |
|---|---|
|
Parameter nChannel liegt außerhalb des Bereichs. |
|
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 |