IMSVidEVREvent::OnUserEvent method (segment.h)
[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]
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
[in] lEventCode
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.
- 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.)
- The EVR forwards the event to the Filter Graph Manager.
- The Filter Graph Manager forwards the event to the Video Control.
- The Video Control forwards the event to the application by calling OnUserEvent.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | segment.h (include Msvidctl.h) |