Condividi tramite


Metodo ICodecAPI::GetParameterValues (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

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

   
Client minimo supportato Windows XP con SP2 [app desktop | App UWP]
Server minimo supportato Windows Server 2003 R2 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione strmif.h (include Dshow.h)
Libreria Strmiids.lib

Vedi anche

Informazioni di riferimento sulle API codec

API del codificatore

ICodecAPI