Metodo ICodecAPI::GetParameterValues (icodecapi.h)

Il metodo GetParameterValues ottiene l'elenco dei valori possibili per una proprietà codec.

Questo metodo si applica solo alle proprietà che supportano un elenco di valori possibili, anziché a un intervallo lineare.

Sintassi

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

Parametri

[in] Api

Puntatore a un GUID che specifica la proprietà di cui eseguire la query. Per un elenco delle proprietà del codec standard, vedere Proprietà dell'API Codec.

[out] Values

Riceve un puntatore a una matrice di tipi VARIANT . La matrice contiene l'elenco di valori supportati dal codificatore per questa proprietà. Il chiamante deve liberare ogni VARIANT chiamando VariantClear. Il chiamante deve anche liberare la matrice chiamando CoTaskMemFree.

[out] ValuesCount

Riceve il numero di elementi nella matrice Values .

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_INVALIDARG	Argomento non valido.
VFW_E_CODECAPI_LINEAR_RANGE	La proprietà supporta un intervallo di valori, non un elenco.

Commenti

Se la proprietà supporta un intervallo di valori, anziché un elenco, il metodo restituisce VFW_E_CODECAPI_LINEAR_RANGE. In tal caso, chiamare ICodecAPI::GetParameterRange per ottenere l'intervallo di valori.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 Build 20348
Server minimo supportato	Windows 10 Build 20348
Intestazione	icodecapi.h

Vedi anche

Informazioni di riferimento sulle API codec

API del codificatore

ICodecAPI