Metodo IMFMediaTypeHandler::IsMediaTypeSupported (mfidl.h)

  • Articolo

Esegue una query che indica se l'oggetto supporta un tipo di supporto specificato.

Sintassi

HRESULT IsMediaTypeSupported(
  [in]  IMFMediaType *pMediaType,
  [out] IMFMediaType **ppMediaType
);

Parametri

[in] pMediaType

Puntatore all'interfaccia IMFMediaType del tipo di supporto da controllare.

[out] ppMediaType

Riceve un puntatore all'interfaccia IMFMediaType del tipo di supporto corrispondente più vicino o riceve il valore NULL. Se non è NULL, il chiamante deve rilasciare l'interfaccia. Questo parametro può essere NULL. Vedere la sezione Osservazioni.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito Descrizione
S_OK
 Il metodo è riuscito.
MF_E_INVALIDMEDIATYPE
 L'oggetto non supporta questo tipo di supporto.

Commenti

Se l'oggetto supporta il tipo di supporto specificato in pMediaType, il metodo restituisce S_OK. Per un'origine multimediale, significa che l'origine può generare dati conformi a tale tipo di supporto. Per un sink multimediale, significa che il sink può ricevere dati conformi a tale tipo di supporto. Se l'oggetto non supporta il tipo di supporto, il metodo ha esito negativo.

Il parametro ppMediaType è facoltativo. Se il metodo ha esito negativo, l'oggetto potrebbe usare ppMediaType per restituire un tipo di supporto supportato dall'oggetto e che corrisponde a quello specificato in pMediaType. Non è garantito che il metodo restituisca un tipo di supporto in ppMediaType. Se non viene restituito alcun tipo, questo parametro riceve un puntatore NULL . Se il metodo ha esito positivo, questo parametro riceve un puntatore NULL . Se il chiamante imposta ppMediaType su NULL, questo parametro viene ignorato.

Questa interfaccia è disponibile nelle piattaforme seguenti se vengono installati i componenti ridistribuibili di Windows Media Format 11 SDK:

  • Windows XP con Service Pack 2 (SP2) e versioni successive.
  • Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) e KB925766 (aggiornamento cumulativo di ottobre 2006 per Windows XP Media Center Edition) installato.
Questa interfaccia è disponibile nelle piattaforme seguenti se vengono installati i componenti ridistribuibili di Windows Media Format 11 SDK:
  • Windows XP con SP2 e versioni successive.
  • Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) e KB925766 (aggiornamento cumulativo di ottobre 2006 per Windows XP Media Center Edition) installato.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione mfidl.h
Libreria Mfuuid.lib

Vedi anche

IMFMediaTypeHandler