Compartilhar via

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

  • Artigo

[O recurso associado a esta página, Microsoft TV Technologies, é um recurso herdado. A Microsoft recomenda fortemente que o novo código não use esse recurso.]

[IEncoderAPI não está mais disponível para uso. Em vez disso, use ICodecAPI.]

O método GetParameterRange recupera o intervalo válido de valores aos quais o parâmetro dá suporte, nos casos em que o parâmetro dá suporte a um intervalo de nível em vez de uma lista de valores específicos.

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 o parâmetro .

[out] ValueMin

Ponteiro para um tipo VARIANT que recebe o valor mínimo do parâmetro.

[out] ValueMax

Ponteiro para um tipo VARIANT que recebe o valor máximo do parâmetro.

[out] SteppingDelta

Ponteiro para um tipo VARIANT que recebe o delta de etapas, que define os incrementos válidos de ValueMin para ValueMax.

Retornar valor

Esse método pode retornar um desses valores.

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

Comentários

O intervalo válido para o parâmetro é [ValueMax... ValueMax], com incrementos de SteppingDelta. Se um parâmetro der suporte a um intervalo de valores escalonado, ele 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 float: VT_R8, VT_R4
Por definição, o parâmetro retornará um tipo específico.

Qualquer valor de etapa é válido. Se o intervalo não tiver nenhum delta de depuração (ou seja, você poderá incrementar por qualquer valor), o codificador deverá retornar um valor vazio (VT_EMPTY) para SteppingDelta.

Se a API for igual a ENCAPIPARAM_BITRATE_MODE, o método retornará E_NOTIMPL, pois as constantes do modo de taxa de bits são uma lista de valores específicos.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

API do codificador

IEncoderAPI Interface