IPerChannelDbLevel::GetLevelRange 方法 (devicetopology.h)
GetLevelRange 方法會取得指定通道音量層級的範圍,以分貝為單位。
語法
HRESULT GetLevelRange(
[in] UINT nChannel,
[out] float *pfMinLevelDB,
[out] float *pfMaxLevelDB,
[out] float *pfStepping
);
參數
[in] nChannel
選取通道的數目。 如果音訊串流有 n 個通道,則通道編號為 0 到 n– 1。 若要取得數據流中的通道數目,請呼叫 IPerChannelDbLevel::GetChannelCount 方法。
[out] pfMinLevelDB
浮 點 數變數的指標,方法會將最小磁碟區層級寫入到其中。
[out] pfMaxLevelDB
浮 點 數變數的指標,方法會在其中寫入最大磁碟區層級的分貝。
[out] pfStepping
浮點數變數的指標,方法會將範圍 *pfMinLevelDB 中連續磁碟區層級之間的逐步執行值寫入 *pfMaxLevelDB。 如果最大值和最小磁碟區層級之間的差異是 d decibels,而且範圍分成 n 個步驟, (統一大小間隔) ,則磁碟區可以有 n + 1 個離散層級,且連續層級之間的步驟大小為 d / n 分貝。
傳回值
如果方法成功,它會傳回 S_OK。 如果失敗,可能的傳回碼包括,但不限於下表所示的值。
傳回碼 | Description |
---|---|
|
參數 nChannel 超出範圍。 |
|
指標 pfminLevelDB、 pfmaxLevelDB 或 pfmaxLevelDB 為 NULL。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | devicetopology.h |