hex_map_alloc

This function creates an empty Hex Map.

Syntax

hex_map_t hex_map_alloc(
        char*             device
);

Parameters

device - the name of the device. If the Hex Map is saved as a HEX file, the device name will be embedded into the HEX file. If this is not needed, use NULL. The device name cannot be longer than 31 characters.

Return

The function returns the new Hex Map object or NULL if creation fails.

On Windows, there are two versions of this function - hex_map_alloc_a (for ASCII) and hex_map_alloc_w (for UNICODE). The "nsdspif.h" file maps hex_map_alloc to one of these functions depending on whether UNICODE is defined or not.

Minimum library version - 163