Compartilhar via

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

  • Artigo

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,
        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 de 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 o VARIANT chamando VariantClear.

ValueMax

[out] SteppingDelta

Ponteiro para uma VARIANT que recebe o delta de etapa, que define os incrementos válidos de ValueMin para ValueMax. O chamador deve liberar o VARIANT chamando VariantClear.

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

Valor retornado

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 sem sinal: VT_UI8, VT_UI4, VT_UI2VT_UI1
  • Tipos assinados: VT_I8, VT_I4, VT_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

   
Cliente mínimo com suporte Windows 10 Build 20348
Servidor mínimo com suporte Windows 10 Build 20348
Cabeçalho icodecapi.h

Confira também

Referência de API do Codec

API do codificador

ICodecAPI