Inside Macintosh: /

QuickDraw 3D RAVE / QuickDraw 3D RAVE Reference

QuickDraw 3D RAVE Routines / Managing Drawing Engines

QADeviceGetNextEngine

You can use the QADeviceGetNextEngine function to get the next drawing engine that can draw to a particular device.

TQAEngine *QADeviceGetNextEngine (
                                  const TQADevice *device, 
                                  const TQAEngine *currentEngine);

device

A device, or the value NULL.

currentEngine

A drawing engine.

DESCRIPTION

The QADeviceGetNextEngine function returns, as its function result, the drawing engine that supports the device specified by the device parameter that follows the engine specified by the currentEngine parameter. The value you pass in the currentEngine parameter should have been obtained from a previous call to QADeviceGetFirstEngine or QADeviceGetNextEngine.

If you pass the value NULL in the device parameter, QADeviceGetNextEngine returns a the next drawing engine without regard for its ability to drive any particular device. You can use this technique to find all available engines.