EC_COMPLETE
A version of this page is also available for
4/8/2010
All data has been rendered. Renderers send this event notification.
Parameters
- lParam1
HRESULT value of some operation. This can be S_OK.
- lParam2
Zero or the renderer's IBaseFilter pointer.
Remarks
The default is not to send this event notification to the application.
You can override the default by calling the IMediaEvent::CancelDefaultHandling method.
No more data should be accepted after the EndOfStream method is called on the renderer's input pin.
Exactly one EC_COMPLETE notification must be sent for each logical stream.
Stopping a renderer resets any end-of-stream state that is cached.
Although individual EC_COMPLETE events are not sent by default, the last individual EC_COMPLETE is sent to the application when all streams have sent one to the filter graph.
If default handling is turned off, the application gets them all (one per stream).
If default handling is enabled, the lParam2 argument is null.
If it is disabled, lParam2 contains the IBaseFilter pointer of the sending filter or null if the filter does not provide it.
As with all events, call IMediaEvent::FreeEventParams to release resources held by the event.
For information on how to use this event code, see CBaseFilter::NotifyEvent.
Requirements
| Windows Embedded CE | Windows CE 2.12 and later |
| Windows Mobile | Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment |