The getRootObject() function

Gets the root object of a pad, or returns NULL if the pad does not exist.

Syntax

The function has the following syntax:

virtual void * getRootObject(size_t size)

Description

This size value must match the size that is specified in the setRootObject() call to ensure that the function is retrieving the root for the expected object. The getRootObject() function returns the root object if it is set, NULL otherwise.

Throws

The function throws an exception if the root object is set but the size that is specified is not equal to the size that the object was registered with using setRootObject().