Xlat_API_Fixed_Len

Xlat_API_Fixed_Len  Segment, Offset, Length

Copies a fixed number of bytes from the specified protected-mode address to the translation copy buffer and converts the address into a V86-mode address.

• No return value.

Segment

Specifies the segment register containing the selector for the protected-mode address.

Offset

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

Length

Specifies the length (in bytes) of the data to copy. The V86MMGR_Xlat_API service fails if there is not enough room in the translation buffer to copy the specified number of bytes.

For example, Get Current Directory (Interrupt 21h Function 47h) is called with the DS:SI register pair pointing to a 64-byte buffer. The following script translates this function:

DOS_Get_Current_Directory_API:
    Xlat_API_Fixed_Len ds, si, 64
    Xlat_API_Exec_Int  21h