次の方法で共有


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) を返す。

参照