IAMTimeline::CreateEmptyNode

 
Microsoft DirectShow 9.0

IAMTimeline::CreateEmptyNode

The CreateEmptyNode method creates a new timeline object.

Use this method to create timeline objects, rather than the CoCreateInstance function, because this method performs important initialization routines. Every object created by this method supports at least the IAMTimelineObj interface, along with other interfaces specific to that type of object.

Syntax

  HRESULT CreateEmptyNode(
    IAMTimelineObj **ppObj,
    TIMELINE_MAJOR_TYPE Type
);

Parameters

ppObj

[out] Address of a pointer that receives the new object's IAMTimelineObj interface.

Type

Member of the TIMELINE_MAJOR_TYPE enumerated type, specifying the type of object to create.

Return Value

Returns one of the following HRESULT values.

Return code Description
S_OK Success.
E_INVALIDARG Object type is not valid.
E_OUTOFMEMORY Insufficient memory.
E_POINTER NULL pointer argument.

Remarks

Do not add the new object to another timeline instance. Every object in a timeline must be created by that timeline.

If the method succeeds, the IAMTimelineObj interface that it returns has an outstanding reference count. Be sure to release the interface when you are finished using it.

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