IMFMediaEventQueue::QueueEventParamVar Method

Artikel
07/27/2011

Creates an event, sets a PROPVARIANT as the event data, and puts the event in the queue.

Call this method inside your implementation of IMFMediaEventGenerator::QueueEvent. Pass the parameters from that method directly to this method.

You can also call this method when your component needs to raise an event that does not contain attributes. If the event data is an IUnknown pointer, you can use IMFMediaEventQueue::QueueEventParamUnk. If the event contains attributes, use IMFMediaEventQueue::QueueEvent instead.

Syntax

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

Parameter

met [in]
Specifies the type of the event to be added to the queue. The event type is returned by the event's IMFMediaEvent::GetType method. For a list of event types, see Media Foundation Events.
guidExtendedType [in]
The extended type of the event. If the event does not have an extended type, use the value GUID_NULL. The extended type is returned by the event's IMFMediaEvent::GetExtendedType method.
hrStatus [in]
A success or failure code indicating the status of the event. This value is returned by the event's IMFMediaEvent::GetStatus method.
pvValue [in]
Pointer to a PROPVARIANT that contains the event value. This parameter can be NULL. This value is returned by the event's IMFMediaEvent::GetValue method.

Rückgabewert

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Rückgabecode	Beschreibung
S_OK	The method succeeded.
MF_E_SHUTDOWN	The Shutdown method was called.

Hinweise

This interface is available on the following platforms if the Windows Media Format 11 SDK redistributable components are installed:

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

Anforderungen

Mindestens unterstützter Client	Windows Vista
Mindestens unterstützter Server	Windows Server 2008
Header	Mfobjects.h (include Mfidl.h)
Bibliothek	Mfuuid.lib

Siehe auch

IMFMediaEventQueue

Freigeben über