IMFPMediaPlayer::GetMediaItem-Methode (mfplay.h)

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

Ruft einen Zeiger auf das aktuelle Medienelement ab.

Syntax

HRESULT GetMediaItem(
  [out] IMFPMediaItem **ppIMFPMediaItem
);

Parameter

[out] ppIMFPMediaItem

Empfängt einen Zeiger auf die IMFPMediaItem-Schnittstelle des Medienelements. 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
S_OK
 Die Methode wurde erfolgreich ausgeführt.
E_FAIL
 Es gibt kein aktuelles Medienelement.
MF_E_NOT_FOUND
 Es gibt kein aktuelles Medienelement.
MF_E_SHUTDOWN
 Die Shutdown-Methode des Objekts wurde aufgerufen.

Hinweise

Die IMFPMediaPlayer::SetMediaItem-Methode ist asynchron. Daher gibt GetMediaItem, während SetMediaItem aussteht, das soeben festgelegte Medienelement nicht zurück. Stattdessen sollte die Anwendung die IMFPMediaPlayerCallback-Schnittstelle implementieren und das MFP_EVENT_TYPE_MEDIAITEM_SET-Ereignis behandeln. Weitere Informationen finden Sie unter Empfangen von Ereignissen vom Player.

Die vorherige Bemerkung gilt auch für das Festlegen des Medienelements in der Funktion MFPCreateMediaPlayer .

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