IMFMediaEventGenerator::GetEvent-Methode (mfobjects.h)

  • Artikel

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