Metodo ICodecAPI::GetParameterValues (strmif.h)

Articolo
07/28/2023

[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

Share via