(v13) status_device return the status of the device itself

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

TEXT

  int32 status_device ( DEVICELIST *dev ,
  DEVSTAT *devstat);
  typedef struct DEVSTAT {
  uint32 block_size ; /* block size */
  HqU32x2 size ; /* size of device, in bytes */ HqU32x2 free ; /* free space on device, in bytes */ uint8 * start; /* %pagebuffer% device only */
  } DEVSTAT ;

This routine returns information on the device: size is the current size of the device and free is the amount of space available on the device. The interpretation of these is device-dependent, but for a device that supports files such as a hard disk, size should be the total size of the device, and free should be the space left that future operations can consume. The sizes are measured in units of 1024 bytes.

This routine should return 0 if successful or -1 if an error occurred (and then last_error will be called to determine the type of error)