IEncoderAPI::GetParameterRange 方法 (strmif.h)
[與此頁面相關聯的 功能 Microsoft TV Technologies 是舊版功能。 Microsoft 強烈建議新程序代碼不使用此功能。]
[IEncoderAPI 不再可供使用。 請改用 ICodecAPI。]
GetParameterRange 方法會擷取參數支援的有效值範圍,以防參數支援階梯狀範圍,而不是特定值的清單。
語法
HRESULT GetParameterRange(
[in] const GUID *Api,
[out] VARIANT *ValueMin,
[out] VARIANT *ValueMax,
[out] VARIANT *SteppingDelta
);
參數
[in] Api
指定 參數之 GUID 的指標。
[out] ValueMin
接收參數最小值之 VARIANT 類型的指標。
[out] ValueMax
VARIANT 型別的指標,可接收參數的最大值。
[out] SteppingDelta
接收逐步執行差異之 VARIANT 類型的指標,它會定義從 ValueMin 到 ValueMax 的有效增量。
傳回值
這個方法可以傳回下列其中一個值。
傳回碼 | 描述 |
---|---|
|
此方法已成功。 |
|
屬性支援可能值的清單,而不是線性範圍。 |
備註
參數的有效範圍是 [ValueMax...ValueMax],遞增為 逐步執行Delta。 如果參數支援階梯狀範圍的值,則必須使用下列其中一種變體類型:
- 不帶正負號的類型:VT_UI8、VT_UI4、VT_UI2、VT_UI1
- 帶正負號的類型: VT_I8、 VT_I4、 VT_I2
- 浮點數類型: VT_R8、 VT_R4
任何逐步執行值都是有效的。 如果範圍沒有逐步執行差異 (,您可以遞增任何值) ,編碼器應該會傳回空白值 (VT_EMPTY) 的逐步執行Delta。
如果 Api 等於 ENCAPIPARAM_BITRATE_MODE,則方法會 傳回E_NOTIMPL,因為比特率模式常數是特定值的清單。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | strmif.h (包含 Dshow.h) |
程式庫 | Strmiids.lib |