hex_map_set_device

This function sets a device name for the Hex Map object. If the Hex Map is saved as a HEX file, the device name will be embedded into the HEX file.

Syntax

int hex_map_set_device(
        hex_map_t         map,
        char*             device
);

Parameters

map - a reference to the Hex Map object

device - the name of the device, or NULL if you want to remove the device name from the Hex Map. The device name cannot be longer than 31 characters.

Return

The function returns non-zero if the name was added/removed, or zero if the operation failed.

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

Minimum library version - 163