MÉTHODE IMFMediaTypeHandler::SetCurrentMediaType (mfidl.h)

  • Article

Définit le type de média de l’objet.

Syntaxe

HRESULT SetCurrentMediaType(
  [in] IMFMediaType *pMediaType
);

Paramètres

[in] pMediaType

Pointeur vers l’interface IMFMediaType du nouveau type de média.

Valeur retournée

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_INVALIDREQUEST
 Demande non valide.

Notes

Pour les sources multimédias, la définition du type de média signifie que la source génère des données conformes à ce type de média. Pour les récepteurs multimédias, la définition du type de média signifie que le récepteur peut recevoir des données conformes à ce type de média.

Toute implémentation de cette méthode doit case activée si pMediaType diffère du type de média actuel de l’objet. Si les types sont identiques, la méthode doit retourner S_OK mais éviter de libérer et de recréer des ressources inutilement. Si les types ne sont pas identiques, la méthode doit valider le nouveau type.

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 Édition Media Center 2005 avec KB900325 (Windows XP Édition Media Center 2005) et KB925766 (correctif cumulatif d’octobre 2006 pour Windows XP Édition Media Center) installés.

Spécifications

   
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