IEncoderAPI::GetParameterRange
注 : IEncoderAPI インターフェイスの使用は避けること。代わりにICodecAPI を使用する。
GetParameterRange メソッドは、引数が特定の値のリストではなく、ステップされる範囲をサポートするような場合に、引数がサポートする有効な値の範囲を取得する。
構文
HRESULT GetParameterRange(
const GUID* Api,
VARIANT* ValueMin,
VARIANT* ValueMax,
VARIANT* SteppingDelta
);
パラメータ
Api
[in] パラメータを指定する GUID へのポインタ。
ValueMin
[out] パラメータの最小値を受け取る VARIANT 型へのポインタ。
ValueMax
[out] パラメータの最大値を受け取る VARIANT 型へのポインタ。
SteppingDelta
[out] ValueMin から ValueMax への有効な増分を定義するステップ デルタを受け取る VARIANT 型へのポインタ。
戻り値
メソッドが成功すると S_OK を返す。失敗すると HRESULT エラー コードを返す。
注意
Api が ** ENCAPIPARAM_BITRATE_MODE と等しい場合、ビットレート モード定数は特定の値のリストなので、このメソッドは E_NOTIMPL を返す。
このパラメータの有効な範囲は [ValueMin ... ValueMax] で、増分は SteppingDelta である。パラメータが、値のステップ範囲をサポートしている場合、次に示すバリアント型のいずれかを使用しなければならない。
- 符号なし型 :VT_UI8、VT_UI4、VT_UI2、VT_UI1
- 符号付き型 :VT_I8、VT_I4、VT_I2
- 浮動小数点型 :VT_R8、VT_R4
定義上、このパラメータは特定の型を返す。
どのステップ値も有効である。 範囲がステップ デルタを持っていない場合 (つまり、任意の値だけインクリメントできる場合)、エンコーダは SteppingDelta に対し空の値 (VT_EMPTY) を返す。
参照