MFCreateSourceReaderFromMediaSource-Funktion (mfreadwrite.h)

Erstellt den Quellleser aus einer Medienquelle.

Syntax

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

Die 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 "Attribute des Quelllesers". 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ögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

Bemerkungen

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

Wenn die Anwendung den Quellleser loslässt, beendet der Quellleser die Medienquelle standardmäßig durch Aufrufen von IMFMediaSource::Shutdown für die Medienquelle. 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.

Wenn Sie den Quellleser verwenden, rufen Sie 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 Plattformupdate-Ergänzung für Windows Vista installiert ist.

Anforderungen

Siehe auch

Media Foundation-Funktionen

Quellleser