Compartir a través de


Método ICodecAPI::GetParameterValues (strmif.h)

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El método GetParameterValues obtiene la lista de valores posibles para una propiedad de códec.

Este método solo se aplica a las propiedades que admiten una lista de valores posibles, en lugar de a un intervalo lineal.

Sintaxis

HRESULT GetParameterValues(
  [in]  const GUID *Api,
  [out] VARIANT    **Values,
  [out] ULONG      *ValuesCount
);

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] Values

Recibe un puntero a una matriz de tipos VARIANT . La matriz contiene la lista de valores que admite el codificador para esta propiedad. El autor de la llamada debe liberar cada VARIANT llamando a VariantClear. El autor de la llamada también debe liberar la matriz llamando a CoTaskMemFree.

[out] ValuesCount

Recibe el número de elementos de la matriz Values .

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_INVALIDARG
Argumento no válido.
VFW_E_CODECAPI_LINEAR_RANGE
La propiedad admite un intervalo de valores, no una lista.

Observaciones

Si la propiedad admite un intervalo de valores, en lugar de una lista, el método devuelve VFW_E_CODECAPI_LINEAR_RANGE. En ese caso, llame a ICodecAPI::GetParameterRange para obtener el intervalo de valores.

Requisitos

   
Cliente mínimo compatible Windows XP con SP2 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado strmif.h (incluya Dshow.h)
Library Strmiids.lib

Consulte también

Referencia de la API de códec

API de codificador

ICodecAPI