Método ICodecAPI::GetParameterRange (icodecapi.h)

  • Artículo

El método GetParameterRange obtiene el intervalo de valores de una propiedad de códec.

Este método solo se aplica a las propiedades cuyos valores forman un intervalo lineal.

Sintaxis

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

Parámetros

[in] Api

Puntero a un GUID que especifica la propiedad que se va a consultar. Para obtener una lista de las propiedades de códec estándar, consulte Propiedades de la API de códec.

[out] ValueMin

Puntero a un variant que recibe el valor mínimo de la propiedad. El autor de la llamada debe liberar el VARIANT llamando a VariantClear.

ValueMax

[out] SteppingDelta

Puntero a un valor VARIANT que recibe el delta de ejecución paso a paso, que define los incrementos válidos de ValueMin a ValueMax. El autor de la llamada debe liberar el VARIANT llamando a VariantClear.

Si el tipo VARIANT es VT_EMPTY, cualquier incremento es válido.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
E_INVALIDARG
 Argumento no válido.
S_OK
 El método se ha llevado a cabo de forma correcta.
VFW_E_CODECAPI_ENUMERATED
 La propiedad admite una lista de valores posibles, no un intervalo lineal.

Comentarios

El intervalo válido para la propiedad es [ValueMin... ValueMax], con incrementos de SteppingDelta. Si una propiedad admite un intervalo lineal de valores, la propiedad debe usar uno de los siguientes tipos de variante:

  • Tipos sin firmar: VT_UI8, VT_UI4, VT_UI2, VT_UI1
  • Tipos firmados: VT_I8, VT_I4, VT_I2
  • Tipos de punto flotante: VT_R8, VT_R4
Si la propiedad admite una lista de valores, en lugar de un intervalo, el método devuelve VFW_E_CODECAPI_ENUMERATED. En ese caso, llame a ICodecAPI::GetParameterValues para obtener la lista de valores.

Requisitos

   
Cliente mínimo compatible Compilación 20348 de Windows 10
Servidor mínimo compatible Compilación 20348 de Windows 10
Encabezado icodecapi.h

Consulte también

Referencia de la API de códec

API de codificador

ICodecAPI