IMFPMediaPlayer::CreateMediaItemFromURL-Methode (mfplay.h)
Erstellt ein Medienelement aus einer URL.
Syntax
HRESULT CreateMediaItemFromURL(
[in] LPCWSTR pwszURL,
[in] BOOL fSync,
[in] DWORD_PTR dwUserData,
[out] IMFPMediaItem **ppMediaItem
);
Parameter
[in] pwszURL
Null-beendete Zeichenfolge, die die URL einer Mediendatei enthält.
[in] fSync
Bei TRUE blockiert die -Methode, bis sie abgeschlossen ist. Bei FALSE wird die Methode nicht blockiert und asynchron abgeschlossen.
[in] dwUserData
Anwendungsdefinierter Wert, der im Medienelement gespeichert werden soll. Um diesen Wert aus dem Medienelement abzurufen, rufen Sie IMFPMediaItem::GetUserData auf.
[out] ppMediaItem
Empfängt einen Zeiger auf die IMFPMediaItem-Schnittstelle . Der Aufrufer muss die Schnittstelle freigeben. Wenn fSyncTRUE ist, muss dieser Parameter ein gültiger Zeiger sein. Wenn bSyncFALSE ist, muss dieser Parameter NULL sein.
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. |
|
Ungültiges Argument. |
|
Ungültige Anforderung. Dieser Fehler kann auftreten, wenn fSyncFALSE ist und die Anwendung keine Rückrufschnittstelle bereitgestellt hat. Siehe Hinweise. |
|
Die Shutdown-Methode des Objekts wurde aufgerufen. |
|
Nicht unterstütztes Protokoll. |
Hinweise
Bei dieser Methode wird das Medienelement nicht für die Wiedergabe in die Warteschlange gestellt. Um das Element für die Wiedergabe in eine Warteschlange zu stellen, rufen Sie IMFPMediaPlayer::SetMediaItem auf.
Die CreateMediaItemFromURL-Methode kann synchron oder asynchron aufgerufen werden:
- Wenn fSyncTRUE ist, wird die -Methode synchron abgeschlossen. Der IMFPMediaItem-Zeiger wird im ppMediaItem-Parameter zurückgegeben.
- Wenn fSyncFALSE ist, wird die -Methode asynchron abgeschlossen. Nach Abschluss des Vorgangs wird die IMFPMediaPlayerCallback::OnMediaPlayerEvent-Rückrufmethode der Anwendung aufgerufen. Der Ereignistyp ist MFP_EVENT_TYPE_MEDIAITEM_CREATED. Die Ereignisdaten enthalten den IMFPMediaItem-Zeiger für das neue Medienelement.
Wenn Sie mehrere asynchrone Aufrufe von CreateMediaItemFromURL tätigen, wird nicht garantiert, dass diese in derselben Reihenfolge ausgeführt werden. Verwenden Sie den dwUserData-Parameter , um erstellte Medienelemente mit ausstehenden Anforderungen abzugleichen.
Derzeit gibt diese Methode MF_E_UNSUPPORTED_SCHEME zurück, wenn die URL eines der folgenden Protokolle angibt: rtsp*, mms* oder mcast. Wenn Sie die Media Foundation-Netzwerkquelle mit MFPlay verwenden möchten, verwenden Sie zuerst den Quelllöser , um die Quelle zu erstellen, und rufen Sie dann IMFPMediaPlayer::CreateMediaItemFromObject auf.
Konfigurieren der Quelle
Intern erstellt diese Methode eine Medienquelle. Gehen Sie wie folgt vor, um die Medienquelle zu konfigurieren:- Rufen Sie QueryInterface auf dem IMFPMediaPlayer-Zeiger auf, um die IPropertyStore-Schnittstelle abzurufen.
- Rufen Sie IPropertyStore::SetValue auf, um Eigenschaften für die Medienquelle festzulegen. Eine Liste der Konfigurationseigenschaften finden Sie unter Konfigurieren einer Medienquelle. Medienquellen von Drittanbietern können benutzerdefinierte Eigenschaften definieren.
- Rufen Sie die CreateMediaItemFromURL-Methode auf, um das Medienelement zu erstellen.
Anforderungen
Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | mfplay.h |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für