Edit

IMFMediaEventQueue interface (mfobjects.h)

  • Article

Provides an event queue for applications that need to implement the IMFMediaEventGenerator interface.

This interface is exposed by a helper object that implements an event queue. If you are writing a component that implements the IMFMediaEventGenerator interface, you can use this object in your implementation. The event queue object is thread safe and provides methods to queue events and to pull them from the queue either synchronously or asynchronously. To create the event queue object, call MFCreateEventQueue.

Inheritance

The IMFMediaEventQueue interface inherits from the IUnknown interface. IMFMediaEventQueue also has these types of members:

Methods

The IMFMediaEventQueue interface has these methods.

 
IMFMediaEventQueue::BeginGetEvent

Begins an asynchronous request for the next event in the queue.Call this method inside your implementation of IMFMediaEventGenerator::BeginGetEvent. Pass the parameters from that method directly to this method.
IMFMediaEventQueue::EndGetEvent

Completes an asynchronous request for the next event in the queue.Call this method inside your implementation of IMFMediaEventGenerator::EndGetEvent. Pass the parameters from that method directly to this method.
IMFMediaEventQueue::GetEvent

Retrieves the next event in the queue. This method is synchronous.Call this method inside your implementation of IMFMediaEventGenerator::GetEvent. Pass the parameters from that method directly to this method.
IMFMediaEventQueue::QueueEvent

Puts an event in the queue.
IMFMediaEventQueue::QueueEventParamUnk

Creates an event, sets an IUnknown pointer as the event data, and puts the event in the queue.
IMFMediaEventQueue::QueueEventParamVar

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.
IMFMediaEventQueue::Shutdown

Shuts down the event queue.

Remarks

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

  • Windows XP with Service Pack 2 (SP2) and later.
  • Windows XP Media Center Edition 2005 with KB900325 (Windows XP Media Center Edition 2005) and KB925766 (October 2006 Update Rollup for Windows XP Media Center Edition) installed.

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)

See also

Media Event Generators

Media Foundation Interfaces