IMFPMediaPlayer::SetMediaItem-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.

 

Stellt ein Medienelement für die Wiedergabe in die Warteschlange.

Syntax

HRESULT SetMediaItem(
  [in] IMFPMediaItem *pIMFPMediaItem
);

Parameter

[in] pIMFPMediaItem

Zeiger auf die IMFPMediaItem-Schnittstelle des Medienelements.

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_DRM_UNSUPPORTED	Das Medienelement enthält geschützte Inhalte. MFPlay unterstützt derzeit keine geschützten Inhalte.
MF_E_NO_AUDIO_PLAYBACK_DEVICE	Es wurde kein Audiowiedergabegerät gefunden. Dieser Fehler kann auftreten, wenn die Medienquelle Audio enthält, aber keine Audiowiedergabegeräte auf dem System verfügbar sind.
MF_E_SHUTDOWN	Die Shutdown-Methode des Objekts wurde aufgerufen.

Hinweise

Diese Methode wird asynchron abgeschlossen. Nach Abschluss des Vorgangs wird die IMFPMediaPlayerCallback::OnMediaPlayerEvent-Rückrufmethode der Anwendung aufgerufen. Der Ereignistyp ist MFP_EVENT_TYPE_MEDIAITEM_SET.

Um ein Medienelement zu erstellen, rufen Sie IMFPMediaPlayer::CreateMediaItemFromObject oder IMFPMediaPlayer::CreateMediaItemFromURL auf. Ein Medienelement muss mit demselben MFPlay-Playerobjekt verwendet werden, das dieses Element erstellt hat. Wenn das Medienelement von einem anderen instance des Playerobjekts erstellt wurde, gibt SetMediaItemE_INVALIDARG zurück.

Anforderungen

Anforderung	Wert
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