(v13) D_CLEAR_ERROR

This page applies to Harlequin v13.1r0 and later; and to Harlequin MultiRIP but not Harlequin Core

D_CLEAR_ERROR Selector

Parameter: a NULL pointer

The RIP calls this selector after the plugin reports an error in the deviceDefinition's d_error field.

If the plugin can clear the error, it should do so. It should at least test whether the condition that caused the error still exists, and modify d_error on the basis of this test if necessary.

D_CLEAR_ERROR is called whenever the error status changes. Therefore, as well as in the places shown in Figure: Error handling call sequences , it is also called at some point after the error is cleared, when the state has changed from some error to no error.

The plugin should do nothing with an error code of DERR_NONE unless it has a special interpretation of the code.

With some error types, the RIP may repeat this call until the error has been cleared. It calls it a final time when it detects the change in d_error back to normal, that is

DERR(DETYPE_CONTINUE, DERR_NONE)

Note: Unless the plugin never changes d_error , it must implement D_CLEAR_ERROR .