Share via


Fonction MFCreateSourceReaderFromMediaSource (mfreadwrite.h)

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 :

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