Método ICodecAPI::GetParameterRange (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 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,
[out] 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 variant llamando a VariantClear.
[out] ValueMax
Puntero a un variant que recibe el valor máximo de la propiedad. El autor de la llamada debe liberar variant llamando a VariantClear.
[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 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 |
---|---|
|
Argumento no válido. |
|
El método se ha llevado a cabo de forma correcta. |
|
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 signo: VT_UI8, VT_UI4, VT_UI2, VT_UI1
- Tipos firmados: VT_I8, VT_I4, VT_I2
- Tipos de punto flotante: VT_R8, VT_R4
Requisitos
Requisito | Value |
---|---|
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 |