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

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O método GetParameterRange obtém o intervalo de valores de uma propriedade codec.

Esse método se aplica somente a propriedades cujos valores formam um intervalo linear.

Sintaxe

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

Parâmetros

[in] Api

Ponteiro para um GUID que especifica a propriedade a ser consultada. Para obter uma lista de propriedades codec padrão, consulte Propriedades da API codec.

[out] ValueMin

Ponteiro para um VARIANT que recebe o valor mínimo da propriedade. O chamador deve liberar VARIANT chamandoVariantClear.

[out] ValueMax

Ponteiro para um VARIANT que recebe o valor máximo da propriedade. O chamador deve liberar VARIANT chamandoVariantClear.

[out] SteppingDelta

Ponteiro para um VARIANT que recebe o delta de etapas, que define os incrementos válidos de ValueMin para ValueMax. O chamador deve liberar VARIANT chamandoVariantClear.

Se o tipo VARIANT for VT_EMPTY, qualquer incremento será válido.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
E_INVALIDARG
 Argumento inválido.
S_OK
 O método foi bem-sucedido.
VFW_E_CODECAPI_ENUMERATED
 A propriedade dá suporte a uma lista de valores possíveis, não a um intervalo linear.

Comentários

O intervalo válido para a propriedade é [ValueMin... ValueMax], com incrementos de SteppingDelta. Se uma propriedade der suporte a um intervalo linear de valores, a propriedade deverá usar um dos seguintes tipos de variante:

  • Tipos não assinados: VT_UI8, VT_UI4, VT_UI2VT_UI1
  • Tipos assinados: VT_I8, VT_I4VT_I2
  • Tipos de ponto flutuante: VT_R8, VT_R4
Se a propriedade der suporte a uma lista de valores, em vez de um intervalo, o método retornará VFW_E_CODECAPI_ENUMERATED. Nesse caso, chame ICodecAPI::GetParameterValues para obter a lista de valores.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

Referência da API do Codec

API do codificador

ICodecAPI