MFCreateSourceReaderFromMediaSource-Funktion (mfreadwrite.h)

  • Artikel

Erstellt den Quellleser aus einer Medienquelle.

Syntax

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

Parameter

[in] pMediaSource

Ein Zeiger auf die IMFMediaSource-Schnittstelle einer Medienquelle.

[in] pAttributes

Zeiger auf die IMFAttributes-Schnittstelle . Sie können diesen Parameter verwenden, um den Quellleser zu konfigurieren. Weitere Informationen finden Sie unter Quellleserattribute. Dieser Parameter kann NULL sein.

[out] ppSourceReader

Empfängt einen Zeiger auf die IMFSourceReader-Schnittstelle . Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode Beschreibung
S_OK
 Die Methode wurde erfolgreich ausgeführt.
MF_E_DRM_UNSUPPORTED
 Die Quelle enthält geschützte Inhalte.

Hinweise

Rufen Sie CoInitialize(Ex) und MFStartup auf, bevor Sie diese Funktion aufrufen.

Wenn die Anwendung den Quellleser freigibt, fährt der Quellleser standardmäßig die Medienquelle herunter, indem er IMFMediaSource::Shutdown für die Medienquelle aufruft. Zu diesem Zeitpunkt kann die Anwendung die Medienquelle nicht mehr verwenden.

Um dieses Standardverhalten zu ändern, legen Sie das attribut MF_SOURCE_READER_DISCONNECT_MEDIASOURCE_ON_SHUTDOWN im pAttributes-Parameter fest. Wenn dieses Attribut TRUE ist, ist die Anwendung für das Herunterfahren der Medienquelle verantwortlich.

Rufen Sie bei Verwendung des Quelllesers keine der folgenden Methoden für die Medienquelle auf:

Diese Funktion ist unter Windows Vista verfügbar, wenn die Plattformupdateergänzung für Windows Vista installiert ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7, Windows Vista und Plattform-Update-Ergänzung für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfreadwrite.h
Bibliothek Mfreadwrite.lib
DLL Mfreadwrite.dll

Weitere Informationen

Media Foundation-Funktionen

Quellleser