MFCreateMediaEvent-Funktion (mfapi.h)

Erstellt ein Medienereignisobjekt.

Syntax

HRESULT MFCreateMediaEvent(
  MediaEventType    met,
  REFGUID           guidExtendedType,
  HRESULT           hrStatus,
  const PROPVARIANT *pvValue,
  IMFMediaEvent     **ppEvent
);

Parameter

met

Der Ereignistyp. Siehe IMFMediaEvent::GetType. Eine Liste der Ereignistypen finden Sie unter Media Foundation-Ereignisse.

guidExtendedType

Der erweiterte Typ. Siehe IMFMediaEvent::GetExtendedType. Wenn der Ereignistyp keinen erweiterten Typ aufweist, verwenden Sie den Wert GUID_NULL.

hrStatus

Das Ereignis status. Siehe IMFMediaEvent::GetStatus

pvValue

Der dem Ereignis zugeordnete Wert, falls vorhanden. Siehe IMFMediaEvent::GetValue. Dieser Parameter kann NULL sein.

ppEvent

Empfängt einen Zeiger auf die IMFMediaEvent-Schnittstelle . Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

Die Funktion 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.

Hinweise

Diese Funktion ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Windows Media Format 11 SDK-Komponenten installiert sind:

  • Windows XP mit Service Pack 2 (SP2) und höher.
  • Windows XP Media Center Edition 2005 mit KB900325 (Windows XP Media Center Edition 2005) und KB925766 (Updaterollup für Windows XP Media Center Edition vom Oktober 2006) installiert.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfapi.h
Bibliothek Mfplat.lib
DLL Mfplat.dll

Weitere Informationen

IMFMediaEvent

Media Foundation-Funktionen