EC_SEGMENT_STARTED

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

A new segment has started.

Parameters

lParam1

(const REFERENCE_TIME*) Pointer to a REFERENCE_TIME value that specifies the accumulated stream time since the start of the segment, in 100-nanosecond units.

lParam2

(DWORD) Segment number (zero-based).

Default Action

This event is not sent to the application. Applications cannot override the default action for this event.

Remarks

If a filter will send an EC_END_OF_SEGMENT at the end of a segment, it sends this event at the start of the segment. The filter graph manager uses this event notification to compute how many EC_END_OF_SEGMENT notifications it should expect at the end of the segment.

By default, filters do not send EC_END_OF_SEGMENT events at the end of segments, and therefore should not send this event. For more information, see IMediaSeeking::SetPositions.

Requirements

Requirement Value
Header
Dshow.h

See also

Event Notification Codes

Event Notification in DirectShow