MFCreateSourceReaderFromMediaSource-Funktion (mfreadwrite.h)

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.

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:

• IMFMediaSource::P ause
• IMFMediaSource::Start
• IMFMediaSource::Stop
• Alle IMFMediaEventGenerator-Methoden

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

Anforderungen

Weitere Informationen

Media Foundation-Funktionen

Quellleser