ICodecAPI::GetParameterRange

  • [アーティクル]

GetParameterRange メソッドは、引数の有効な値の範囲を返す。このメソッドは、特定の値の一覧ではなく、ステップされる値の範囲をサポートするような引数に適用される。

構文

  HRESULT GetParameterRange(
  const GUID*  Api,
  VARIANT*  ValueMin,
  VARIANT*  ValueMax,
  VARIANT*  SteppingDelta
);

パラメータ

Api

[in] 引数を指定する GUID へのポインタ。

ValueMin

[out] 引数の最小値を受け取る VARIANT 型へのポインタ。

ValueMax

[out] 引数の最大値を受け取る VARIANT 型へのポインタ。

SteppingDelta

[out] ステップ デルタを受け取る VARIANT 型へのポインタ。ステップ デルタは、ValueMin から ValueMax への有効な増分を定義する。

戻り値

メソッドが成功すると S_OK を返す。失敗すると HRESULT エラー コードを返す。

注意

引数の有効な範囲は [ValueMin ... ValueMax] で、増分は SteppingDelta である。引数がステップされる値の範囲をサポートする場合、以下のバリアント型のいずれかを使う必要がある。

  • 符号なし型 :VT_UI8、VT_UI4、VT_UI2、VT_UI1
  • 符号付き型 :VT_I8、VT_I4、VT_I2
  • 浮動小数点型 :VT_R8、VT_R4

引数は当然、特定の型を返す。

任意のステップ値が有効である。範囲にステップ デルタがない場合 (任意の値によりインクリメントできる)、エンコーダは SteppingDelta に空の値 (VT_EMPTY) を返す必要がある。

参照