Important: The information in this document is obsolete and should not be used for new development.
Getting the Available Graphics DevicesTo gain access to the
GDevicerecord for a video device--for example, to determine the size and pixel depth of its attached screen--your application needs to get a handle to that record.
Your application can use the
GetDeviceListfunction to obtain a handle to the first
GDevicerecord in the device list, the
GetGDevicefunction to obtain a handle to the
GDevicerecord for the current device, the
GetMainDevicefunction to obtain a handle to the
GDevicerecord for the main screen, and the
GetMaxDevicefunction to obtain a handle to the
GDevicerecord for the video device with the greatest pixel depth.
GDevicerecords are linked together in the device list. After using one of these functions to obtain a handle to one of the
GDevicerecords in the device list, your application can use the
GetNextDevicefunction to obtain a handle to the next
GDevicerecord in the list.
Two related functions,
GetGWorldDevice, also allow you to obtain handles to
GDevicerecords. To get the
GDevicerecord for the current device, you can use the
GetGWorldfunction. To get a handle to the
GDevicerecord for a particular offscreen graphics world, you can use the
GetGWorldDevicefunction. These two functions are described in the next chapter, "Offscreen Graphics Worlds."