Fonction MFCreateSourceReaderFromMediaSource (mfreadwrite.h)

Article
03/02/2024

Crée le lecteur source à partir d’une source multimédia.

Syntaxe

HRESULT MFCreateSourceReaderFromMediaSource(
  [in]  IMFMediaSource  *pMediaSource,
  [in]  IMFAttributes   *pAttributes,
  [out] IMFSourceReader **ppSourceReader
);

Paramètres

[in] pMediaSource

Pointeur vers l’interface IMFMediaSource d’une source multimédia.

[in] pAttributes

Pointeur vers l’interface IMFAttributes . Vous pouvez utiliser ce paramètre pour configurer le lecteur source. Pour plus d’informations, consultez Attributs de lecteur source. Ce paramètre peut être NULL.

[out] ppSourceReader

Reçoit un pointeur vers l’interface IMFSourceReader . L’appelant doit libérer l’interface.

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_DRM_UNSUPPORTED	La source contient du contenu protégé.

Remarques

Appelez CoInitialize(Ex) et MFStartup avant d’appeler cette fonction.

Par défaut, lorsque l’application libère le lecteur source, le lecteur source arrête la source multimédia en appelant IMFMediaSource ::Shutdown sur la source multimédia. À ce stade, l’application ne peut plus utiliser la source multimédia.

Pour modifier ce comportement par défaut, définissez l’attribut MF_SOURCE_READER_DISCONNECT_MEDIASOURCE_ON_SHUTDOWN dans le paramètre pAttributes . Si cet attribut a la valeur TRUE, l’application est responsable de l’arrêt de la source multimédia.

Lorsque vous utilisez le lecteur source, n’appelez aucune des méthodes suivantes sur la source multimédia :

IMFMediaSource ::P ause
IMFMediaSource ::Start
IMFMediaSource ::Stop
Toutes les méthodes IMFMediaEventGenerator

Cette fonction est disponible sur Windows Vista si le Supplément de mise à jour de la plateforme pour Windows Vista est installé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Supplément windows 7, Windows Vista et mise à jour de la plateforme pour Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	mfreadwrite.h
Bibliothèque	Mfreadwrite.lib
DLL	Mfreadwrite.dll

Voir aussi

Fonctions Media Foundation

Lecteur source

Partager via