Share via

IMSVidEVREvent::OnUserEvent Method

  • Article

This topic applies to Windows Vista or later.
The OnUserEvent method forwards custom events from the enhanced video renderer (EVR) filter.

Syntax

HRESULT OnUserEvent(
  [in]  long lEventCode
);

Parameters

  • lEventCode [in]
    Event code.

Return Value

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

The purpose of this method is to forward custom events from an EVR presenter to the application through the Video Control.

  1. The presenter calls IMediaEventSink::Notify on the EVR with an event code of EC_USER or higher. (This range of values is reserved for custom graph events.)
  2. The EVR forwards the event to the Filter Graph Manager.
  3. The Filter Graph Manager forwards the event to the Video Control.
  4. The Video Control forwards the event to the application by calling OnUserEvent.

The dispatch identifier (dispid) of this method is dispidUserEvent.

Requirements

Header Declared in Dshow.h.
DLL Requires Quartz.dll.

See Also

IMSVidEVREvent Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008