Méthode IMFMediaTypeHandler ::IsMediaTypeSupported (mfidl.h)

  • Article

Demande si l’objet prend en charge un type de média spécifié.

Syntaxe

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

Paramètres

[in] pMediaType

Pointeur vers l’interface IMFMediaType du type multimédia vers case activée.

[out] ppMediaType

Reçoit un pointeur vers l’interface IMFMediaType du type de média correspondant le plus proche ou reçoit la valeur NULL. Si elle n’est pas NULL, l’appelant doit libérer l’interface. Ce paramètre peut être NULL. Consultez la section Notes.

Valeur de retour

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
 S_OK
MF_E_INVALIDMEDIATYPE
 L’objet ne prend pas en charge ce type de média.

Remarques

Si l’objet prend en charge le type de média donné dans pMediaType, la méthode retourne S_OK. Pour une source multimédia, cela signifie que la source peut générer des données conformes à ce type de média. Pour un récepteur multimédia, cela signifie que le récepteur peut recevoir des données conformes à ce type de média. Si l’objet ne prend pas en charge le type de média, la méthode échoue.

Le paramètre ppMediaType est facultatif. Si la méthode échoue, l’objet peut utiliser ppMediaType pour renvoyer un type de média que l’objet prend en charge et qui correspond étroitement à celui donné dans pMediaType. Il n’est pas garanti que la méthode retourne un type de média dans ppMediaType. Si aucun type n’est retourné, ce paramètre reçoit un pointeur NULL . Si la méthode réussit, ce paramètre reçoit un pointeur NULL . Si l’appelant définit ppMediaType sur NULL, ce paramètre est ignoré.

Cette interface est disponible sur les plateformes suivantes si les composants redistribuables du SDK Windows Media Format 11 sont installés :

  • Windows XP avec Service Pack 2 (SP2) et versions ultérieures.
  • Windows XP Media Center Edition 2005 avec KB900325 (Windows XP Media Center Edition 2005) et KB925766 (correctif cumulatif d’octobre 2006 pour Windows XP Édition Media Center) installés.
Cette interface est disponible sur les plateformes suivantes si les composants redistribuables du SDK Windows Media Format 11 sont installés :
  • Windows XP avec SP2 et versions ultérieures.
  • Windows XP Media Center Edition 2005 avec KB900325 (Windows XP Media Center Edition 2005) et KB925766 (correctif cumulatif d’octobre 2006 pour Windows XP Édition Media Center) installés.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête mfidl.h
Bibliothèque Mfuuid.lib

Voir aussi

IMFMediaTypeHandler