CO_MEMORY_CREATE

 co_memory co_memory_create(const char *name,                            const char *loc,                            size_t size); 

Header File

co.h

Description

This function creates a shared memory. It must be called from within the configuration function of your application.

Arguments

The arguments for co_memory_create are as follows:

const char *name	A programmer-defined name. This name may be any text string. It is used to identify the memory externally, such as when using the Application Monitor.
const char *loc	Specifies the architecture-specific physical location associated with this memory. The set of valid values for this argument is platform-dependent. (See your Platform Support Package documentation.)
size_t size	The size of the memory in bytes.

Return Value

A pointer to the created memory. This return value may subsequently be used as an argument to the function co_process_create.

Notes

Memory names, as specified in the first argument to co_memory_create, must be unique across the application when using the Application Monitor.

In simulation, this function prints an error message and terminates the application if it is called outside the configuration function.