IMFMediaEventQueue::QueueEventParamUnk-Methode (mfobjects.h)

  • Artikel

Erstellt ein Ereignis, legt einen IUnknown-Zeiger als Ereignisdaten fest und legt das Ereignis in die Warteschlange.

Syntax

HRESULT QueueEventParamUnk(
  [in] MediaEventType met,
  [in] REFGUID        guidExtendedType,
  [in] HRESULT        hrStatus,
  [in] IUnknown       *pUnk
);

Parameter

[in] met

Gibt den Ereignistyp des Ereignisses an, das der Warteschlange hinzugefügt werden soll. Der Ereignistyp wird von der IMFMediaEvent::GetType-Methode des Ereignisses zurückgegeben. Eine Liste der Ereignistypen finden Sie unter Media Foundation-Ereignisse.

[in] guidExtendedType

Der erweiterte Typ des Ereignisses. Wenn das Ereignis keinen erweiterten Typ aufweist, verwenden Sie den Wert GUID_NULL. Der erweiterte Typ wird von der IMFMediaEvent::GetExtendedType-Methode des Ereignisses zurückgegeben.

[in] hrStatus

Ein Erfolgs- oder Fehlercode, der die status des Ereignisses angibt. Dieser Wert wird von der IMFMediaEvent::GetStatus-Methode des Ereignisses zurückgegeben.

[in] pUnk

Zeiger auf die IUnknown-Schnittstelle . Die -Methode legt diesen Zeiger als Ereigniswert fest. Der Zeiger wird von der IMFMediaEvent::GetValue-Methode des Ereignisses zurückgegeben.

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.
MF_E_SHUTDOWN
 Die Shutdown-Methode wurde aufgerufen.

Hinweise

Rufen Sie diese Methode auf, wenn Ihre Komponente ein Ereignis auslösen muss, das einen IUnknown-Zeigerwert und keine Attribute enthält. Wenn das Ereignis Attribute enthält, verwenden Sie stattdessen IMFMediaEventQueue::QueueEvent .

Diese Schnittstelle 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

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

IMFMediaEventQueue