Xlat_API_ASCIIZ

Xlat_API_ASCIIZ Segment, Offset


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

Parameters

Segment

Specifies the register containing the selector of the protected-mode address.

Offset

Specifies the register containing the offset of the protected-mode address.

Return Value

This macro has no return value.

Comments

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.

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

See Also

Xlat_API_Exec_Int