Fonction MFPCreateMediaPlayer (mfplay.h)

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.

 

Crée une instance de l’objet lecteur MFPlay.

Syntaxe

HRESULT MFPCreateMediaPlayer(
  [in]  LPCWSTR                 pwszURL,
  [in]  BOOL                    fStartPlayback,
  [in]  MFP_CREATION_OPTIONS    creationOptions,
  [in]  IMFPMediaPlayerCallback *pCallback,
  [in]  HWND                    hWnd,
  [out] IMFPMediaPlayer         **ppMediaPlayer
);

Paramètres

[in] pwszURL

Chaîne terminée par null qui contient l’URL d’un fichier multimédia à ouvrir. Ce paramètre peut être NULL. Si le paramètre a la valeur NULL, fStartPlayback doit avoir la valeur FALSE.

Si ce paramètre a la valeur NULL, vous pouvez ouvrir une URL ultérieurement en appelant IMFPMediaPlayer ::CreateMediaItemFromURL.

[in] fStartPlayback

Si la valeur EST TRUE, la lecture démarre automatiquement. Si la valeur est FALSE, la lecture ne démarre pas tant que l’application n’appelle IMFMediaPlayer ::P lay.

Si pwszURL a la valeur NULL, ce paramètre est ignoré.

[in] creationOptions

OR au niveau du bit de zéro des indicateurs supplémentaires de l’énumération _MFP_CREATION_OPTIONS.

[in] pCallback

Pointeur vers l’interface IMFPMediaPlayerCallback d’un objet de rappel, implémenté par l’application. Utilisez cette interface pour obtenir des notifications d’événements à partir de l’objet de lecteur MFPlay. Ce paramètre peut être NULL. Si le paramètre a la valeur NULL, l’application ne recevra pas de notifications d’événements de l’objet lecteur.

[in] hWnd

Handle d’une fenêtre dans laquelle la vidéo s’affiche. Pour la lecture audio uniquement, ce paramètre peut avoir la valeur NULL.

La fenêtre spécifiée par hWnd est utilisée pour le premier flux vidéo sélectionné dans la source. Si la source a plusieurs flux vidéo, vous devez appeler IMFPMediaItem ::SetStreamSink pour restituer l’un des flux vidéo après le premier.

Si hWnd a la valeur NULL, MFPlay n’affiche aucune vidéo, sauf si l’application appelle IMFPMediaItem ::SetStreamSink pour spécifier un récepteur multimédia pour le flux vidéo.

[out] ppMediaPlayer

Reçoit un pointeur vers l’interface IMFPMediaPlayer . L’appelant doit libérer l’interface. Ce paramètre peut être NULL. Si ce paramètre a la valeur NULL, fStartPlayback doit avoir la valeur TRUE et pwszURL ne peut pas avoir la valeur NULL.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Avant d’appeler cette fonction, appelez CoIntialize(Ex) à partir du même thread pour initialiser la bibliothèque COM.

En interne, MFPCreateMediaPlayer appelle MFStartup pour initialiser la plateforme Microsoft Media Foundation. Lorsque l’objet joueur est détruit, il appelle MFShutdown pour arrêter la plateforme. Il n’est pas nécessaire pour une application d’appeler MFStartup ou MFShutdown lors de l’utilisation de MFPlay.

Note Si vous utilisez d’autres API Media Foundation en dehors de la durée de vie de l’objet lecteur, votre application doit appeler MFStartup et MFShutdown.

 

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
Bibliothèque	Mfplay.lib
DLL	Mfplay.dll

Voir aussi

Fonctions Media Foundation

Utilisation de MFPlay pour la lecture audio/vidéo