Compartir a través de

Método IEncoderAPI::GetParameterRange (strmif.h)

  • Artículo

[La característica asociada a esta página, Microsoft TV Technologies, es una característica heredada. Microsoft recomienda encarecidamente que el nuevo código no use esta característica.

[IEncoderAPI ya no está disponible para su uso. En su lugar, use ICodecAPI.]

El método GetParameterRange recupera el intervalo válido de valores que admite el parámetro, en los casos en los que el parámetro admite un intervalo escalonado en lugar de una lista de valores específicos.

Sintaxis

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

Parámetros

[in] Api

Puntero a un GUID que especifica el parámetro .

[out] ValueMin

Puntero a un tipo VARIANT que recibe el valor mínimo del parámetro.

[out] ValueMax

Puntero a un tipo VARIANT que recibe el valor máximo del parámetro.

[out] SteppingDelta

Puntero a un tipo VARIANT que recibe el delta de ejecución paso a paso, que define los incrementos válidos de ValueMin a ValueMax.

Valor devuelto

Este método puede devolver uno de estos valores.

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

Comentarios

El intervalo válido para el parámetro es [ValueMax... ValueMax], con incrementos de SteppingDelta. Si un parámetro admite un intervalo escalonado de valores, 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 float: VT_R8, VT_R4
Por definición, el parámetro devolverá un tipo específico.

Cualquier valor de ejecución paso a paso es válido. Si el intervalo no tiene ninguna diferencia paso a paso (es decir, puede incrementar por cualquier valor), el codificador debe devolver un valor vacío (VT_EMPTY) para SteppingDelta.

Si api es igual a ENCAPIPARAM_BITRATE_MODE, el método devuelve E_NOTIMPL, porque las constantes de modo de velocidad de bits son una lista de valores específicos.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado strmif.h (incluye Dshow.h)
Library Strmiids.lib

Consulte también

API de codificador

IEncoderAPI (Interfaz)