Legacy Document

Inside Macintosh: Imaging With QuickDraw /

Chapter 5 - Graphics Devices / Graphics Devices Reference

Routines for Graphics Devices / Getting the Available Graphics Devices

GetGDevice

To obtain a handle to the GDevice record for the current device, use the GetGDevice function.

FUNCTION GetGDevice: GDHandle;

DESCRIPTION

The GetGDevice function returns a handle to the GDevice record for the current device. (At any given time, exactly one video device is the current device--that is, the one on which drawing is actually taking place.)

Color QuickDraw stores a handle to the current device in the global variable TheGDevice.

SPECIAL CONSIDERATIONS

The GetGDevice function may move or purge memory blocks in the application heap. Your application should not call this function at interrupt time.