Xlat_API_ASCIIZ

Xlat_API_ASCIIZ  Segment, Offset

Copies a null-terminated string from the protected-mode address into the translation copy buffer, and converts the address to a V86-mode address.

• No return value.

Segment

Register containing the selector of the protected-mode address.

Offset

Register containing the offset of the protected-mode address.

This macro does not copy the string back after the call is complete. This macro fails if there is not enough room in the translation buffer to copy the string.

For example, Rename File (Interrupt 21h Function 56h) is called with two null-terminated filenames. The following script translates this function:

Rename_API:
    Xlat_API_ASCIIZ   ds, dx
    Xlat_API_ASCIIZ   es, di
    Xlat_API_Exec_Int 21h