Compartilhar via

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

  • Artigo

O método GetParameterValues obtém a lista de valores possíveis para uma propriedade codec.

Esse método se aplica apenas a propriedades que dão suporte a uma lista de valores possíveis, em vez de um intervalo linear.

Sintaxe

HRESULT GetParameterValues(
  [in]  const GUID *Api,
  [out] VARIANT    **Values,
  [out] ULONG      *ValuesCount
);

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] Values

Recebe um ponteiro para uma matriz de tipos VARIANT . A matriz contém a lista de valores compatíveis com o codificador para essa propriedade. O chamador deve liberar cada VARIANT chamando VariantClear. O chamador também deve liberar a matriz chamando CoTaskMemFree.

[out] ValuesCount

Recebe o número de elementos na matriz Valores.

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_INVALIDARG
 Argumento inválido.
VFW_E_CODECAPI_LINEAR_RANGE
 A propriedade dá suporte a um intervalo de valores, não a uma lista.

Comentários

Se a propriedade der suporte a um intervalo de valores, em vez de uma lista, o método retornará VFW_E_CODECAPI_LINEAR_RANGE. Nesse caso, chame ICodecAPI::GetParameterRange para obter o intervalo de valores.

Requisitos

Requisito Valor
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