IAMTimelineSrc::SpliceWithNext
Microsoft DirectShow 9.0 |
IAMTimelineSrc::SpliceWithNext
The SpliceWithNext method joins the source object to another source object.
Syntax
HRESULT SpliceWithNext( IAMTimelineObj *pNext );
Parameters
pNext
Pointer to the IAMTimelineObj interface of the source object to join to the current source.
Return Value
Returns an HRESULT value. Possible return values include the following:
Value | Description |
S_OK | Success. |
E_INVALIDARG | Invalid argument. |
E_NOINTERFACE | Object specified by pNext parameter is not a source object. |
E_POINTER | NULL pointer argument. |
Remarks
As currently implemented, this method discards any effects on pNext.
For this method to succeed, pNext must be a match frame of the current source object, defined as follows:
- It must share the same source file.
- The media start time must equal the media stop time of the current source.
- The playback rate must be the same. Playback rate is media duration divided by timeline duration.
Requirements
Header: Include Qedit.h. This header file is not compatible with Microsoft® Direct3D® headers later than version 7.
Library: Use strmiids.lib.
See Also