MFCreateSourceReaderFromMediaSource, fonction (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 du 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

La méthode retourne un HRESULT. Les valeurs possibles incluent, mais ne sont pas limitées à celles du tableau suivant.

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 plateforme pour Windows Vista est installé.

Spécifications

Voir aussi

Fonctions Media Foundation

Lecteur source