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) を返す必要がある。
参照