Xlat_API_Fixed_Len

Xlat_API_Fixed_Len Segment, Offset, Length


The Xlat_API_Fixed_Len macro 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.

Parameters

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.

Return Value

This macro has no return value.

Comments

This service fails if there is not enough room in the translation buffer to copy the data.

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

See Also

Xlat_API_Exec_Int, Xlat_API_Var_Len