Digital

NAME

XieCallocBits − This routine allocates zeroed memory for an image data array. 

C Format

pointer = XieCallocBits(bits)

C Argument Information

unsigned char  ∗pointer;
unsigned     bits;

RETURN VALUES

The routine returns a pointer to the allocated image data array in the pointer argument.  If the routine fails, the routine returns null.  After using the memory, you should free the memory using the XieFreeBits routine. 

PARAMETERS

bitsThe bits argument specifies the size of the allocated image data array in bits. 

DESCRIPTION

This routine allocates zeroed memory for an image data array.  The size of the data array is specified by the size argument. 

XIE Events and Error Messages

Protocol Messages: None

XIE event returned: None

XieLib errors: Returns a null if the routine cannot allocate the memory

XieServer errors: None