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 |
|---|---|
|
Il metodo è riuscito. |
|
Argomento non valido. |
|
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 |