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

[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.

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

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

Confira também

API do codificador

IEncoderAPI Interface