(v13) start_param begin listing the device parameters

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

int32 start_param ( DEVICELIST *dev);

This routine returns the number of parameters that the device wishes to have returned by the PostScript language operator currentdevparams . This returned number need not be the same as the number of device parameter names recognized by the device, because some device parameters can be ‘write-only', or a parameter may only be returned once a value has been set for it. The number excludes the parameters that are handled by the interpreter itself (/Password, /DeviceType, /Enable ). Following this call, get_param will be called multiple times (with a NULL paramname ) to get each of the parameters.

If there are no such device parameters, 0 should be returned. If an error occurs, -1 should be returned.

NOTE:   The iteration cannot be thread-safe, so can generally only be used from PostScript language code, or code called from the PostScript language.