Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

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.