IMFMediaEventQueue interface (mfobjects.h)
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) |