# IBM Visualization Data Explorer Programmer's Reference

[ Bottom of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]

### DXAllocate, DXAllocateZero, DXAllocateLocal, DXAllocateLocalZero, DXAllocateLocalOnly, DXAllocateLocalOnlyZero

Function Allocate global or local memory.

Syntax

    #include <dx/dx.h>
    Pointer DXAllocate(unsigned int n)
    Pointer DXAllocateZero(unsigned int n)
    Pointer DXAllocateLocal(unsigned int n)
    Pointer DXAllocateLocalZero(unsigned int n)
    Pointer DXAllocateLocalOnly(unsigned int n)
    Pointer DXAllocateLocalOnlyZero(unsigned int n)

.

Functional Details For all of these routines, `n` must be greater than zero.

`DXAllocate` | Allocates `n` bytes of memory in global memory.
`DXAllocateZero` | Allocates and clears `n` bytes of global memory.
`DXAllocateLocal` | On platforms with per-processor local memory (such as multiprocessor workstations), allocates `n` bytes of memory in local memory.
`DXAllocateLocalZero` | Allocates `n` bytes in local memory and zeros the allocated memory.
`DXAllocateLocal`, `DXAllocateLocalZero` | If `n` bytes of local memory are not available, allocate them from global memory.
`DXAllocateLocalOnly`, `DXAllocateLocalOnlyZero` | Allocate local memory only.

On platforms without per-processor local memory (such as all currently supported workstations), `DXAllocateLocal` is identical to `DXAllocate`.

Although local is usually faster than global access, local memory should be used only for Objects within a task or for parts of a module not in a task Group: Objects in local memory cannot be shared between processors. Objects that are the output of a module must be in global memory.

Note: Memory allocated by any routine listed here should be freed (with DXFree) when it is no longer needed.

Return Value Returns a pointer to the allocated memory or returns `NULL` and sets an error code.

See Also `DXAbortTaskGroup, DXAddTask, DXCreateTaskGroup, DXExecuteTaskGroup, DXFree, DXPrintAlloc, DXReAllocate`

13.3 , "Memory Allocation".

[ Top of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]
[Data Explorer Documentation | QuickStart Guide | User's Guide | User's Reference | Programmer's Reference | Installation and Configuration Guide ]

[Data Explorer Home Page | Contact Data Explorer | Same document on Data Explorer Home Page ]

[IBM Home Page | Order | Search | Contact IBM | Legal ]