IMFMediaEventGenerator::QueueEvent method (mfobjects.h)

Puts a new event in the object's queue.

Syntax

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

Parameters

[in] met

Specifies the event type. The event type is returned by the event's IMFMediaEvent::GetType method. For a list of event types, see Media Foundation Events.

[in] guidExtendedType

The extended type. 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.

[in] hrStatus

A success or failure code indicating the status of the event. This value is returned by the event's IMFMediaEvent::GetStatus method.

[in] pvValue

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.

Return value

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

Return code Description
S_OK
The method succeeded.
MF_E_SHUTDOWN
The object was shut down.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header mfobjects.h (include Mfidl.h)
Library Mfuuid.lib

See also

IMFMediaEventGenerator

Media Event Generators