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.
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.
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.