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.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
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:
- 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
| 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 |