Digital

NAME

XieReallocBits − This routine reallocates (changes the size of) a client XieImage data array. 

C Format

new_pointer = XieReallocBits(ptr, bits)

C Argument Information

unsigned char  ∗new_pointer;
unsigned char  ∗ptr;
unsigned     bits;

RETURN VALUES

The routine returns the address of the reallocated image data array in the new_pointer argument.  If the routine fails, the routine returns a null.  If you increase the size of the reallocated data array, the routine zeros the contents of the additional memory. 

If the address returned in the new_pointer argument is different than the address you specified for the ptr argument, the routine moved the original contents of the memory to the new address and deallocated the original data array memory. 

You should free the image array using the XieFreeBits routine. 

PARAMETERS

ptrThe ptr argument specifies the address of the image data array you want to reallocate. 

bitsThe bits argument specifies the size in bits to which you want to change the reallocated memory. 

DESCRIPTION

This routine changes the size (reallocates) of a client XieImage data array. 

XIE Events and Error Messages

Protocol Messages: None

XIE event returned: None

XieLib errors: None

XieServer errors: None