Share via


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