Xlat_API_Var_Len

Xlat_API_Var_Len  Segment, Offset, Length

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

• No return value.

Segment

Segment register containing the selector for the protected-mode address.

Offset

Register containing the offset for the protected-mode address.

Length

Register containing 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, Write String (Interrupt 10h Function 0Eh) is called with the ES:BP register pair pointing to the string to print and the CX register specifying the number of bytes to display. The following script translates this function:

Int_10h_Write_String:
    Xlat_API_Var_Len  es, bp, cx
    Xlat_API_Exec_Int 10h