MFP_EVENT_TYPE-Enumeration (mfplay.h)

Artikel
08/24/2023

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

Definiert Ereignistypen für die IMFPMediaPlayerCallback-Schnittstelle .

Syntax

typedef enum MFP_EVENT_TYPE {
  MFP_EVENT_TYPE_PLAY = 0,
  MFP_EVENT_TYPE_PAUSE = 1,
  MFP_EVENT_TYPE_STOP = 2,
  MFP_EVENT_TYPE_POSITION_SET = 3,
  MFP_EVENT_TYPE_RATE_SET = 4,
  MFP_EVENT_TYPE_MEDIAITEM_CREATED = 5,
  MFP_EVENT_TYPE_MEDIAITEM_SET = 6,
  MFP_EVENT_TYPE_FRAME_STEP = 7,
  MFP_EVENT_TYPE_MEDIAITEM_CLEARED = 8,
  MFP_EVENT_TYPE_MF = 9,
  MFP_EVENT_TYPE_ERROR = 10,
  MFP_EVENT_TYPE_PLAYBACK_ENDED = 11,
  MFP_EVENT_TYPE_ACQUIRE_USER_CREDENTIAL = 12
} ;

Konstanten


`MFP_EVENT_TYPE_PLAY` Wert: 0 Die Wiedergabe wurde gestartet. Dieses Ereignis wird gesendet, wenn die IMFPMediaPlayer::P lay-Methode abgeschlossen ist.
`MFP_EVENT_TYPE_PAUSE` Wert: 1 Die Wiedergabe wurde angehalten. Dieses Ereignis wird gesendet, wenn die IMFPMediaPlayer::P ause-Methode abgeschlossen ist.
`MFP_EVENT_TYPE_STOP` Wert: 2 Die Wiedergabe wurde beendet. Dieses Ereignis wird gesendet, wenn die IMFPMediaPlayer::Stop-Methode abgeschlossen ist.
`MFP_EVENT_TYPE_POSITION_SET` Wert: 3 Das MFPlay-Playerobjekt hat eine neue Wiedergabeposition gesucht. Dieses Ereignis wird gesendet, wenn die IMFPMediaPlayer::SetPosition-Methode abgeschlossen ist.
`MFP_EVENT_TYPE_RATE_SET` Wert: 4 Die Wiedergaberate hat sich geändert. Dieses Ereignis wird gesendet, wenn die IMFPMediaPlayer::SetRate-Methode abgeschlossen ist.
`MFP_EVENT_TYPE_MEDIAITEM_CREATED` Wert: 5 Ein neues Medienelement wurde erstellt. Dieses Ereignis wird gesendet, wenn die IMFPMediaPlayer::CreateMediaItemFromURL - oder CreateMediaItemFromObject-Methode abgeschlossen ist.
`MFP_EVENT_TYPE_MEDIAITEM_SET` Wert: 6 Ein Medienelement ist für die Wiedergabe bereit. Dieses Ereignis wird gesendet, wenn die IMFPMediaPlayer::SetMediaItem-Methode abgeschlossen ist.
`MFP_EVENT_TYPE_FRAME_STEP` Wert: 7 Ein Frameschrittvorgang wurde abgeschlossen. Dieses Ereignis wird gesendet, wenn die IMFPMediaPlayer::FrameStep-Methode abgeschlossen ist.
`MFP_EVENT_TYPE_MEDIAITEM_CLEARED` Wert: 8 Das aktuelle Medienelement wurde gelöscht. Dieses Ereignis wird gesendet, wenn die IMFPMediaPlayer::ClearMediaItem-Methode abgeschlossen ist.
`MFP_EVENT_TYPE_MF` Wert: 9 Ein Pipelineobjekt hat ein Ereignis gesendet. Das Player-Objekt leitet bestimmte Pipelineereignisse an die Anwendung weiter. Weitere Informationen finden Sie unter MFP_MF_EVENT.
`MFP_EVENT_TYPE_ERROR` Wert: 10 Ein Wiedergabefehler ist aufgetreten.
`MFP_EVENT_TYPE_PLAYBACK_ENDED` Wert: 11 Die Wiedergabe wurde beendet. Das Player-Objekt sendet dieses Ereignis, wenn die Wiedergabe das Ende der Mediendatei erreicht.
`MFP_EVENT_TYPE_ACQUIRE_USER_CREDENTIAL` Wert: 12 Die Medienquelle erfordert eine Authentifizierung, bevor sie die Datei wiedergeben kann.

Hinweise

Für jeden Ereignistyp empfängt der IMFPMediaPlayerCallback::OnMediaPlayerEvent-Rückruf einen Zeiger auf eine Datenstruktur. Der erste Teil der Datenstruktur ist immer eine MFP_EVENT_HEADER-Struktur . In der folgenden Tabelle ist die Datenstruktur für jeden Ereignistyp aufgeführt.

In Ihrer Implementierung von OnMediaPlayerEvent müssen Sie den pEventHeader-Parameter in den richtigen Strukturtyp umwandeln. Zu diesem Zweck wird eine Reihe von Makros definiert. Diese Makros überprüfen den Wert des Ereignistyps und geben NULL zurück, wenn ein Konflikt besteht. andernfalls wird ein Zeiger auf den richtigen Strukturtyp zurückgegeben.

Ereignistyp	Ereignisstruktur Zeigerumwandlungsmakro
MFP_EVENT_TYPE_PLAY	MFP_PLAY_EVENT MFP_GET_PLAY_EVENT
MFP_EVENT_TYPE_PAUSE	MFP_PAUSE_EVENT MFP_GET_PAUSE_EVENT
MFP_EVENT_TYPE_STOP	MFP_STOP_EVENT MFP_GET_STOP_EVENT
MFP_EVENT_TYPE_POSITION_SET	MFP_POSITION_SET_EVENT MFP_GET_POSITION_SET_EVENT
MFP_EVENT_TYPE_RATE_SET	MFP_RATE_SET_EVENT MFP_GET_RATE_SET_EVENT
MFP_EVENT_TYPE_MEDIAITEM_CREATED	MFP_MEDIAITEM_CREATED_EVENT MFP_GET_MEDIAITEM_CREATED_EVENT
MFP_EVENT_TYPE_MEDIAITEM_SET	MFP_MEDIAITEM_SET_EVENT MFP_GET_MEDIAITEM_SET_EVENT
MFP_EVENT_TYPE_FRAME_STEP	MFP_FRAME_STEP_EVENT MFP_GET_FRAME_STEP_EVENT
MFP_EVENT_TYPE_MEDIAITEM_CLEARED	MFP_MEDIAITEM_CLEARED_EVENT MFP_GET_MEDIAITEM_CLEARED_EVENT
MFP_EVENT_TYPE_MF	MFP_MF_EVENT MFP_GET_MF_EVENT
MFP_EVENT_TYPE_ERROR	MFP_ERROR_EVENT MFP_GET_ERROR_EVENT
MFP_EVENT_TYPE_PLAYBACK_ENDED	MFP_PLAYBACK_ENDED_EVENT MFP_GET_PLAYBACK_ENDED_EVENT
MFP_EVENT_TYPE_ACQUIRE_USER_CREDENTIAL	MFP_ACQUIRE_USER_CREDENTIAL_EVENT MFP_GET_ACQUIRE_USER_CREDENTIAL_EVENT

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

Media Foundation-Enumerationen