(v13) last_error
This page applies to Harlequin v13.1r0 and later; and to Harlequin Core but not Harlequin MultiRIP
int32 last_error ( DEVICELIST * dev );
This must return the last error produced by any of the other device routines which have been called on this thread. If called at all, it is called immediately following the call to the routine that produced the error (that is, no other device routines will be called in between).
Calls to last_error
(), from any device, should be made in the same thread that made the device call that reported an error. That is, you can't recover the device error in a different thread.
It must return one of the following values (defined in swdevice.h
):
DeviceNoError
DeviceInvalidAccess
DeviceIOError
DeviceLimitCheck
DeviceUndefined
DeviceUnregistered
DeviceInterrupted
DeviceVMError
DeviceReOutput
DeviceNotReady
DeviceCancelPage
DeviceReOutputPageBuffer
The circumstances under which each one should be returned are described in the individual routine descriptions. The last four errors should only be returned by the %pagebuffer%
device.