IMFMediaEventGenerator::GetEvent-Methode (mfobjects.h)

Artikel
02/28/2024

Ruft das nächste Ereignis in der Warteschlange ab. Diese Methode ist synchron.

Syntax

HRESULT GetEvent(
  [in]  DWORD         dwFlags,
  [out] IMFMediaEvent **ppEvent
);

Parameter

[in] dwFlags

Gibt einen der folgenden Werte an.

Wert	Bedeutung
0	Die -Methode blockiert, bis der Ereignisgenerator ein Ereignis in die Warteschlange stellt.
MF_EVENT_FLAG_NO_WAIT	Die -Methode gibt sofort zurück.

[out] ppEvent

Empfängt einen Zeiger auf die IMFMediaEvent-Schnittstelle . 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_INVALIDARG	NULL-Zeigerargument.
MF_E_MULTIPLE_SUBSCRIBERS	Es ist eine ausstehende Anforderung vorhanden.
MF_E_NO_EVENTS_AVAILABLE	Es gibt keine Ereignisse in der Warteschlange.
MF_E_SHUTDOWN	Das Objekt wurde heruntergefahren.

Hinweise

Diese Methode wird synchron ausgeführt.

Wenn die Warteschlange bereits ein Ereignis enthält, gibt die Methode sofort S_OK zurück. Wenn die Warteschlange kein Ereignis enthält, hängt das Verhalten vom Wert von dwFlags ab:

Wenn dwFlags 0 ist, blockiert die Methode unbegrenzt, bis ein neues Ereignis in die Warteschlange gestellt wird oder bis der Ereignisgenerator heruntergefahren wird.
Wenn dwFlags MF_EVENT_FLAG_NO_WAIT ist, schlägt die Methode sofort fehl, wobei der Rückgabecode MF_E_NO_EVENTS_AVAILABLE.

Diese Methode gibt MF_E_MULTIPLE_SUBSCRIBERS zurück, wenn Sie zuvor IMFMediaEventGenerator::BeginGetEvent aufgerufen und noch nicht IMFMediaEventGenerator::EndGetEvent aufgerufen haben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	mfobjects.h (include Mfidl.h)
Bibliothek	Mfuuid.lib

Weitere Informationen

IMFMediaEventGenerator

Medienereignisgeneratoren

Freigeben über