IMFMediaEventQueue::QueueEventParamVar-Methode (mfobjects.h)

Artikel
08/24/2023

Erstellt ein Ereignis, legt einen PROPVARIANT als Ereignisdaten fest und legt das Ereignis in die Warteschlange.

Rufen Sie diese Methode in Ihrer Implementierung von IMFMediaEventGenerator::QueueEvent auf. Übergeben Sie die Parameter dieser Methode direkt an diese Methode.

Sie können diese Methode auch aufrufen, wenn Ihre Komponente ein Ereignis auslösen muss, das keine Attribute enthält. Wenn es sich bei den Ereignisdaten um einen IUnknown-Zeiger handelt, können Sie IMFMediaEventQueue::QueueEventParamUnk verwenden. Wenn das Ereignis Attribute enthält, verwenden Sie stattdessen IMFMediaEventQueue::QueueEvent .

Syntax

HRESULT QueueEventParamVar(
  [in] MediaEventType    met,
  [in] REFGUID           guidExtendedType,
  [in] HRESULT           hrStatus,
  [in] const PROPVARIANT *pvValue
);

Parameter

[in] met

Gibt den Typ 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] pvValue

Zeiger auf eine PROPVARIANT-Eigenschaft , die den Ereigniswert enthält. Dieser Parameter kann NULL sein. Dieser Wert 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

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

Freigeben über