Metodo ICodecAPI::IsSupported (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine 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, FMMediaEngine e Audio/Video Capture in Media Foundation anziché 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 IsSupported esegue una query se un codec supporta una determinata proprietà.

Sintassi

HRESULT IsSupported(
  [in] const GUID *Api
);

Parametri

[in] Api

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

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_FALSE	Il codec non supporta la proprietà.
S_OK	Il codec supporta la proprietà.
E_NOTIMPL	Il codec non supporta la proprietà.

Commenti

Eventuali errori oltre a quelli nella tabella precedente indicano un'incapacità di elaborare la chiamata.

Nota Se il codec non supporta la proprietà, il metodo può restituire S_FALSE o E_NOTIMPL. Il valore E_NOTIMPL è preferibile, ma la documentazione precedente è elencata solo S_FALSE, quindi alcuni codec potrebbero restituire tale valore. Le applicazioni devono testare in modo esplicito il valore S_OK.

 

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 codificatore

ICodecAPI