Microsoft DirectX 8.1 (C++)

IAMTimelineObj::GetSubObject

The GetSubObject method retrieves the subobject associated with this object.

Syntax

HRESULT GetSubObject(
    IUnknown **pVal
);

Parameters

pVal

[out, retval] Address of a pointer that receives the subobject's IUnknown interface. If the object does not have a subobject, the value is set to NULL.

Return Value

Returns S_OK if successful, or E_POINTER otherwise.

Remarks

Every timeline object can hold a pointer to an associated subobject. For example, the subobject of an effect is typically a Microsoft® DirectX® Transform object that generates the effect.

If the value returned in pVal is not NULL, the IUnknown interface has an outstanding reference count. Be sure to release the interface when you are finished using it.

See Also