Méthode IMFPMediaPlayer ::SetMediaItem (mfplay.h)

  • Article
Important Déconseillée. Cette API peut être supprimée des versions ultérieures de Windows. Les applications doivent utiliser la session multimédia pour la lecture.
 

Met en file d’attente un élément multimédia pour la lecture.

Syntaxe

HRESULT SetMediaItem(
  [in] IMFPMediaItem *pIMFPMediaItem
);

Paramètres

[in] pIMFPMediaItem

Pointeur vers l’interface IMFPMediaItem de l’élément multimé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
E_INVALIDARG
 Argument non valide.
MF_E_DRM_UNSUPPORTED
 L’élément multimédia contient du contenu protégé. MFPlay ne prend actuellement pas en charge le contenu protégé.
MF_E_NO_AUDIO_PLAYBACK_DEVICE
 Aucun périphérique de lecture audio n’a été trouvé. Cette erreur peut se produire si la source multimédia contient de l’audio, mais qu’aucun périphérique de lecture audio n’est disponible sur le système.
MF_E_SHUTDOWN
 La méthode Shutdown de l’objet a été appelée.

Remarques

Cette méthode se termine de manière asynchrone. Une fois l’opération terminée, la méthode de rappel IMFPMediaPlayerCallback ::OnMediaPlayerEvent de l’application est appelée. Le type d’événement est MFP_EVENT_TYPE_MEDIAITEM_SET.

Pour créer un élément multimédia, appelez IMFPMediaPlayer ::CreateMediaItemFromObject ou IMFPMediaPlayer ::CreateMediaItemFromURL. Un élément multimédia doit être utilisé avec le même objet de lecteur MFPlay que celui qui a créé cet élément. Si l’élément multimédia a été créé par une autre instance de l’objet lecteur, SetMediaItem retourne E_INVALIDARG.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête mfplay.h

Voir aussi

IMFPMediaPlayer

Utilisation de MFPlay pour la lecture audio/vidéo