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 類型的指標,它會定義從 ValueMinValueMax 的有效增量。

傳回值

這個方法可以傳回下列其中一個值。

傳回碼 描述
S_OK
此方法已成功。
E_NOTIMPL
屬性支援可能值的清單,而不是線性範圍。

備註

參數的有效範圍是 [ValueMax...ValueMax],遞增為 逐步執行Delta。 如果參數支援階梯狀範圍的值,則必須使用下列其中一種變體類型:

  • 不帶正負號的類型:VT_UI8VT_UI4VT_UI2、VT_UI1
  • 帶正負號的類型: VT_I8VT_I4VT_I2
  • 浮點數類型: VT_R8VT_R4
根據定義,參數會傳回特定類型。

任何逐步執行值都是有效的。 如果範圍沒有逐步執行差異 (,您可以遞增任何值) ,編碼器應該會傳回空白值 (VT_EMPTY) 的逐步執行Delta

如果 Api 等於 ENCAPIPARAM_BITRATE_MODE,則方法會 傳回E_NOTIMPL,因為比特率模式常數是特定值的清單。

規格需求

需求
目標平台 Windows
標頭 strmif.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

編碼器 API

IEncoderAPI 介面