Legacy Document

Inside Macintosh: Imaging With QuickDraw /

Chapter 5 - Graphics Devices / Graphics Devices Reference

Routines for Graphics Devices / Getting the Available Graphics Devices

GetNextDevice

After using the GetDeviceList function to obtain a handle to the first GDevice record in the device list, GetGDevice to obtain a handle to the GDevice record for the current device, GetMainDevice to obtain a handle to the GDevice record for the main screen, or GetMaxDevice to obtain a handle to the GDevice record for the video device with the greatest pixel depth, you can use the GetNextDevice function to obtain a handle to the next GDevice record in the list.

FUNCTION GetNextDevice (curDevice: GDHandle): GDHandle;

curDevice

A handle to the GDevice record at which you want the search to begin.

DESCRIPTION

The GetNextDevice function returns a handle to the next GDevice record in the device list. If there are no more GDevice records in the list, it returns NIL.

SPECIAL CONSIDERATIONS

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

SEE ALSO

Listing 5-3 on page 5-9 illustrates the use of this function.