hex_map_get_device

This function extracts a device name from the Hex Map object.

Syntax

int hex_map_get_device(
        hex_map_t         map,
        char*             device
);

Parameters

map - a reference to the Hex Map object

device - the buffer that will be filled with the device name. The buffer must be at least 32 characters long.

Return

If a device name was stored in the Hex Map Object, the function fills in the buffer and returns non-zero, otherwise it returns zero.

Notes

Usually, the Hex Map does not contain the device name. The device name may be present either if the device name was embedded in the HEX file when it was read by hex_map_read or hex_map_read_fd function, or if the device name was added later with hex_map_set_device function.

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

Minimum library version - 163