MFP_MEDIAITEM_CREATED_EVENT-Struktur (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.
 

Ereignisstruktur für das MFP_EVENT_TYPE_MEDIAITEM_CREATED-Ereignis . Dieses Ereignis wird gesendet, wenn die IMFPMediaPlayer::CreateMediaItemFromURL - oder IMFPMediaPlayer::CreateMediaItemFromObject-Methode abgeschlossen ist.

Syntax

typedef struct MFP_MEDIAITEM_CREATED_EVENT {
  MFP_EVENT_HEADER header;
  IMFPMediaItem    *pMediaItem;
  DWORD_PTR        dwUserData;
} MFP_MEDIAITEM_CREATED_EVENT;

Member

header

MFP_EVENT_HEADER Struktur, die Daten enthält, die allen IMFPMediaPlayer-Ereignissen gemeinsam sind.

pMediaItem

Zeiger auf die IMFPMediaItem-Schnittstelle des neuen Medienelements. Wenn beim Erstellen des Medienelements ein Fehler aufgetreten ist, ist dieses Element NULL.

dwUserData

Anwendungsdefinierte Benutzerdaten für das Medienelement. Dieser Wert wird angegeben, wenn die Anwendung CreateMediaItemFromURL oder CreateMediaItemFromObject aufruft.

Hinweise

Um einen Zeiger auf diese Struktur abzurufen, wandeln Sie den pEventHeader-Parameter der IMFPMediaPlayerCallback::OnMediaPlayerEvent-Methode um. Zu diesem Zweck können Sie das Makro MFP_GET_MEDIAITEM_CREATED_EVENT verwenden.

Medienelemente werden asynchron erstellt. Wenn mehrere Elemente erstellt werden, können die Vorgänge in beliebiger Reihenfolge ausgeführt werden, nicht unbedingt in der gleichen Reihenfolge wie die Methodenaufrufe. Sie können das dwUserData-Element verwenden, um die Elemente zu identifizieren, wenn gleichzeitig Anforderungen ausstehen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile mfplay.h

Weitere Informationen

IMFPMediaPlayerCallback

Medienfundamentstrukturen

Verwenden von MFPlay für die Audio-/Videowiedergabe