Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

IMFMediaEventQueue::QueueEventParamUnk method

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

Syntax


HRESULT QueueEventParamUnk(
  [in]  MediaEventType met,
  [in]  REFGUID guidExtendedType,
  [in]  HRESULT hrStatus,
  [in]  IUnknown *pUnk
);

Parameters

met [in]

Specifies the event 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.

pUnk [in]

Pointer to the IUnknown interface. The method sets this pointer as the event value. The pointer 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 Shutdown method was called.

 

Remarks

Call this method when your component needs to raise an event that contains an IUnknown pointer value and no attributes. If the event contains attributes, use IMFMediaEventQueue::QueueEvent instead.

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

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

IMFMediaEventQueue

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.