MFP_MF_EVENT Struktur (mfplay.h)

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_MF-Ereignis . Das MFPlay-Playerobjekt verwendet dieses Ereignis, um bestimmte Ereignisse aus der Media Foundation-Pipeline an die Anwendung weiterzuleiten.

Syntax

typedef struct MFP_MF_EVENT {
  MFP_EVENT_HEADER header;
  MediaEventType   MFEventType;
  IMFMediaEvent    *pMFMediaEvent;
  IMFPMediaItem    *pMediaItem;
} MFP_MF_EVENT;

Member

header

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

MFEventType

Media Foundation-Ereignistyp. Derzeit leitet das MFPlay-Playerobjekt die folgenden Pipelineereignisse an die Anwendung weiter:

Ereignis	BESCHREIBUNG
MEBufferingStarted	Die Quelle hat mit dem Puffern von Daten begonnen.
MEBufferingStopped	Die Quelle hat das Puffern von Daten beendet.
MEExtendedType	Benutzerdefinierter Ereignistyp.
MEReconnectEnd	Die Quelle hat einen Versuch abgeschlossen, die Verbindung mit dem Server wiederherzustellen.
MEReconnectStart	Die Quelle versucht, eine Verbindung mit dem Server wiederherzustellen.
MERendererEvent	Ereignis, das von einem Renderer gesendet wird, z. B . der erweiterte Videorenderer (EVR ).
MEStreamSinkFormatChanged	Ein Streamformat wurde geändert.

pMFMediaEvent

Zeiger auf die IMFMediaEvent-Schnittstelle des Media Foundation-Ereignisses.

pMediaItem

Zeiger auf die IMFPMediaItem-Schnittstelle des aktuellen Medienelements.

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_MF_EVENT verwenden.

Wenn MFEventTypeMEStreamSinkFormatChanged ist, kann die folgende Eigenschaft im Ereigniseigenschaftenspeicher gespeichert werden, auf den über das header.pPropertyStore-Element zugegriffen werden kann.

Eigenschaft	BESCHREIBUNG
MFP_PKEY_StreamIndex	Der Index des Streams, dessen Format sich geändert hat.

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