GRABREQUEST

GrabRequest struc

grlpData dd ? ;long pointer to I/O buffer

grXorg db ? ;x origin (unsigned)

grYorg db ? ;y origin (unsigned)

grXext db ? ;x extent (unsigned)

grYext db ? ;y extent (unsigned)

grStyle db ? ;style flags

grChar db ? ;character code for fill operations

grAttr db ? ;attribute for fill operations

GrabRequest ends

The GRABREQUEST structure contains information used to capture all or a portion of the screen.

Members

grlpData

Contains the address of the buffer to receive or containing the screen data.

grXorg

Specifies the x-origin (unsigned) of the upper-left corner of the block.

grYorg

Specifies the y-origin (unsigned) of the upper-left corner of the block.

grXext

Specifies the x-extent of the block. If grXext is zero, the entire screen width is assumed.

grYext

Specifies the y-extent of the block. If grYext is zero, the entire screen height is assumed.

grStyle

Specifies the type and format of the block operation. It can be a combination of one Screen Operation and one Format value. The following are the values for the Screen Operation.

Value Screen Operation

F_BOTH (00h) Fills with single character and attribute.
F_CHAR (01h) Fills with single character only.
F_ATTR (02h) Fills with single attribute only.
C_BOTH (03h) Copies characters and attributes from grlpData.
C_CHAR (04h) Copies characters only from grlpData.
C_ATTR (05h) Copies attributes only from grlpData.
C_CHAR_F_ATTR (06h) Copies characters from grlpData and fills with single attribute.
C_ATTR_F_CHAR (07h) Copies attributes from grlpData and fills with single character.

The following are the values for Format.

Value Format

FMT_NATIVE (00h) Uses format native to mode.
FMT_OTHER (80h) Uses clipboard format or format specified by the Screen Operation value.

grChar

Specifies a character code for fill operations.

grAttr

Specifies an attribute byte for fill operations.

Comments

All block functions receive a pointer to a GRABREQUEST structure in the ES:DI register pair. Not all the members are used by all functions.

See Also

GetBlock