Synopsis
void *OMXgroup::ret_omx_ptr( const char *class_name);
Description
OMXgroup::ret_omx_ptr casts the object whose method is being called to a pointer to an object of the class specified by the class_name argument. Calling this routine
class_name *my_ptr;
my_ptr = (my_class *)my_grp->ret_omx_ptr("my_class");
is similar to the C++ construct
class_name *my_ptr = (class_name *) my_grp;
You cannot simply use the C++ construct because classes generated with the C++ API use virtual classes. In C++ you cannot cast from a virtual base class to a subclass.
Arguments
class_name
A NULL terminated string specifying the class name of the class you want returned. This class name must be the name of a class in this object's definition or a NULL pointer is returned.
Returned value
This routine returns a void * that you can then cast to the class specified by the class_name argument.