IMFMediaEventGenerator::QueueEvent method

Puts a new event in the object's queue.

Syntax


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

Parameters

met [in]

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.

guidExtendedType [in]

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.

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.

Return value

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

Return codeDescription
S_OK

The method succeeded.

MF_E_SHUTDOWN

The object was shut down.

 

Requirements

Minimum supported client

Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 [desktop apps | Windows Store apps]

Header

Mfobjects.h (include Mfidl.h)

Library

Mfuuid.lib

See also

IMFMediaEventGenerator
Media Event Generators

 

 

Show: