Microsoft DirectX 9.0

IMediaObject::Discontinuity

The Discontinuity method signals a discontinuity on the specified input stream.

Syntax

HRESULT Discontinuity(
    DWORD dwInputStreamIndex
);

Parameters

dwInputStreamIndex

Zero-based index of an input stream on the DMO.

Return Value

Returns an HRESULT value. Possible values include those in the following table.

Return Code Description
DMO_E_INVALIDSTREAMINDEX Invalid stream index
DMO_E_NOTACCEPTING The DMO is not accepting input.
DMO_E_TYPE_NOT_SET The input and output types have not been set.
S_OK Success

Remarks

A discontinuity represents a break in the input. A discontinuity might occur because no more data is expected, the format is changing, or there is a gap in the data. After a discontinuity, the DMO does not accept further input on that stream until all pending data has been processed. The application should call the IMediaObject::ProcessOutput method until none of the streams returns the DMO_OUTPUT_DATA_BUFFERF_INCOMPLETE flag.

This method might fail if it is called before the client sets the input and output types on the DMO.

See Also