IMediaObject::Discontinuity
Microsoft DirectShow 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.
Requirements
Header: Declared in Mediaobj.h; include Dmo.h
Library: Dmoguids.lib.
See Also