CopyOut

Description:              This function copies data from a buffer to an absolute RAM address.

Returns:                    Nothing

Usage:                       Script

Format:                      CopyOut(Buffer, Address, Length)

Parameters:             Buffer    { text }  { required }  { no default: }

                                                Any text expression containing data bytes to copy.

                                    Address    { numeric }  { required }  { no default: }

                                                Any numeric expression giving the absolute RAM address to start to copy.

                                    Length    { numeric }  { required }  { no default: }

                                                Any numeric expression giving the number of bytes to copy.

Comments:               This function requires that the VTSIO driver be installed. Please refer to the topic, Communicating Directly With Hardware for more details.

                                    A buffer is written to RAM at Address. If fewer than Length bytes are in the buffer, the copy will stop when the end of the buffer is reached.

Example:

CopyOut(x, 0x1859:0x0000, 256);

This would copy the first 256 bytes from the text variable x to real-mode RAM segment 1859 (hex) offset 0 to offset FF (hex), unless x is shorter than 256 bytes.

See Also:

CopyIn | MemIn | MemOut