EC_REPAINT

A video renderer requires a repaint.

Parameters

lParam1

Pointer to the IPin interface of the video renderer's input pin, or NULL.

lParam2

Zero.

Default Action

The lParam1 parameter might specify the video renderer's input pin. If so, the filter graph manager finds the output pin connected to that pin and queries it for the IMediaEventSink interface. If the output pin supports IMediaEventSink, the filter graph manager calls IMediaEventSink::Notify with the EC_REPAINT event code. This gives the upstream filter the opportunity to re-send the last sample.

If lParam1 is NULL, or if the pin does not support IMediaEventSink, or if the Notify method fails, the filter graph manager handles the EC_REPAINT event by itself. Its behavior depends on the state of the graph:

• Running: Ignores the event. (The renderer will receive the next sample in the stream.)
• Paused: Seeks the graph to its current location, thereby flushing the filter and re-queuing the data.
• Stopped: Pauses and stops the graph, thereby re-queuing the data.

By default, the filter graph manager does not pass this event to the application.

Remarks

Video renderers send this message when they receive a WM_PAINT message and have no data to display.

See Also

• Event Notification Codes