EC_COMPLETE

  • Article

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 the 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 any resources held by the event.

For information on how to use this event code, see CBaseFilter::NotifyEvent.

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.