Share via


IMFPMediaPlayer::CreateMediaItemFromURL-Methode (mfplay.h)

Wichtig Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden. Anwendungen sollten die Mediensitzung für die Wiedergabe verwenden.
 

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
S_OK
Die Methode wurde erfolgreich ausgeführt.
E_INVALIDARG
Ungültiges Argument.
MF_E_INVALIDREQUEST
Ungültige Anforderung. Dieser Fehler kann auftreten, wenn fSyncFALSE ist und die Anwendung keine Rückrufschnittstelle bereitgestellt hat. Siehe Hinweise.
MF_E_SHUTDOWN
Die Shutdown-Methode des Objekts wurde aufgerufen.
MF_E_UNSUPPORTED_SCHEME
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:

Die Rückrufschnittstelle wird festgelegt, wenn Sie zum ersten Mal MFPCreateMediaPlayer aufrufen, um das MFPlay-Playerobjekt zu erstellen. Wenn Sie keine Rückrufschnittstelle bereitstellen, muss der fSync-ParameterTRUE sein. Andernfalls gibt CreateMediaItemFromURLMF_E_INVALIDREQUEST zurück.

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:
  1. Rufen Sie QueryInterface auf dem IMFPMediaPlayer-Zeiger auf, um die IPropertyStore-Schnittstelle abzurufen.
  2. 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.
  3. 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

IMFPMediaPlayer

Verwenden von MFPlay für die Audio-/Videowiedergabe