ICodecAPI::GetParameterRange メソッド (icodecapi.h)

GetParameterRange メソッドは、コーデックプロパティの値の範囲を取得します。

このメソッドは、値が線形範囲を形成するプロパティにのみ適用されます。

構文

HRESULT GetParameterRange(
  [in]  const GUID *Api,
  [out] VARIANT    *ValueMin,
        VARIANT    *ValueMax,
  [out] VARIANT    *SteppingDelta
);

[in] Api

クエリを実行するプロパティを指定する GUID へのポインター。標準のコーデックプロパティの一覧については、「 Codec API のプロパティ」を参照してください。

[out] ValueMin

プロパティの最小値を受け取る VARIANT へのポインター。呼び出し元は VariantClear を呼び出して VARIANT を解放する必要があります。

ValueMax

[out] SteppingDelta

ValueMin から ValueMax への有効な増分を定義する、ステップデルタを受け取る VARIANT へのポインター。呼び出し元は VariantClear を呼び出して VARIANT を解放する必要があります。

VARIANT 型がVT_EMPTY場合は、任意のインクリメントが有効です。

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

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

プロパティの有効な範囲は [ValueMin.... ValueMax]。 SteppingDelta の増分値を使用します。プロパティが線形範囲の値をサポートする場合、プロパティは次のいずれかのバリアント型を使用する必要があります。

プロパティが範囲ではなく値のリストをサポートしている場合、メソッドは VFW_E_CODECAPI_ENUMERATEDを返します。その場合は、 ICodecAPI::GetParameterValues を呼び出して値の一覧を取得します。