CreateCxObj

create a new commodity object. (V36)

This function creates a commodity object of type 'type'. It is not proper to call this function directly. Each object creation routine except CxBroker() is defined as a macro in <libraries/commodities.h> These are independently documented.

All functions which operate on a commodity object are made with a reference to the thirty-two bit value returned by this function (or by CxBroker()).

type

the type of object to create as defined in <libraries/commodities.h>

arg1

first argument, meaning depends on 'type'

arg2

second argument, meaning depends on 'type'

co

a pointer to the new object or NULL if it could not be created. A NULL return indicates typically a lack of system memory. Minor problems in creating an object, such as providing a bad filter description to amiga.lib/CxFilter(), typically don't cause failure, but are recorded in an internal error field in the new object which can be accessed via CxObjError().

CxObjError(), amiga.lib/CxFilter(), amiga.lib/CxSender(), amiga.lib/CxSignal(), amiga.lib/CxTranslate(), amiga.lib/CxDebug(), amiga.lib/CxCustom(), CxBroker()