GDI Data Types

The data types defined in the following table appear in the device driver interface. Several of the listed data types have already been described in GDI User Objects. Data types that are pointers are marked with an asterisk (*).

Graphics DDI Data Type	Variable Name Prefix	Definition
BOOL	b	A 32-bit value that can be either TRUE or FALSE.
BYTE	j	An 8-bit unsigned integer.
BRUSHOBJ	pbo	A pointer to a brush object.
CLIPLINE	cl	A clipline object.
CLIPOBJ	pco	A pointer to a clipping object.
DHPDEV	dhpdev	A 32-bit handle, defined by the device driver, that identifies a physical device.
DHSURF	dhsurf	A 32-bit handle, defined by the device driver, that identifies a device-managed surface.
FIX	fix	A fixed-point number.
FLOATL	e	A floating-point number.
FLOAT_LONG	el	A 32-bit overloaded value that is interpreted as either a LONG or FLOATL, depending on context.
FLONG	fl	A set of 32-bit flags.
FONTOBJ	pfo	A pointer to a font object.
FSHORT	fs	A set of 16-bit flags.
FWORD	fw	A 16-bit signed integer.
HBM	hbm	A 32-bit handle, defined by GDI, that identifies a bitmap.
HPAL	hpal	A 32-bit handle, defined by GDI, that identifies a palette.
HSURF	hsurf	A 32-bit handle, defined by GDI, that identifies a surface.
LONG	l	A 32-bit signed integer.
MIX	mix	A 32-bit quantity, whose lower 16 bits define foreground and background mix modes.
PALOBJ	ppalo	A pointer to a palette object.
PATHOBJ	ppo	A pointer to a path object.
POINTE	pte	A point structure that consists of {FLOATL x, y;}.
POINTFIX	ptfx	A point structure that consists of {FIX x, y;}.
POINTQF	ptq	A point structure that consists of {LARGE_INTEGER x, y;}. Each member of this structure is a 64-bit coordinate in 28.36 format.
PWSZ	pwsz	A pointer to a null-terminated Unicode string.
PVOID	pv	A pointer to a VOID, an undefined data type.
RECTFX	rcfx	A rectangle structure that consists of {FIX xLeft, yTop, xRight, yBottom;}.
ROP4	rop4	A 32-bit value that specifies how source, destination, pattern, and mask pixels are to be mixed.
SHORT	s	A 16-bit signed integer.
SIZEL	sizl	A structure that consists of {LONG cx, cy;}.
STROBJ	pstro	A pointer to a text string object.
SURFOBJ	pso	A pointer to a surface object.
ULONG	ul	A 32-bit unsigned integer.
USHORT	us	A 16-bit unsigned integer.
XFORMOBJ	pxo	A pointer to a coordinate transform object.
XLATEOBJ*	pxlo	A pointer to a color translation object.

The parameter prefixes listed in the next table are used to modify variable name prefixes in accordance with their usage.

Prefix	Parameter Usage
i	An enumerated index
c	A count
p	A pointer