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

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

このメソッドは、これらの値のいずれかを返すことができます。

リターンコード	説明
S_OK	メソッドが成功しました。
E_NOTIMPL	プロパティは、線形範囲ではなく、使用可能な値の一覧をサポートします。

パラメーターの有効な範囲は [ValueMax...ValueMax]。 SteppingDelta をインクリメントします。パラメーターが値のステップ範囲をサポートしている場合は、次のいずれかのバリアント型を使用する必要があります。

定義上、パラメーターは特定の型を返します。

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

Apiが ENCAPIPARAM_BITRATE_MODEと等しい場合、ビットレートモード定数は特定の値のリストであるため、メソッドはE_NOTIMPLを返します。