next up previous contents index
次へ: sane_set_io_mode 上へ: Operations 戻る: sane_read   目次   索引

sane_cancel

This function is used to immediately or as quickly as possible cancel the currently pending operation of the device represented by handle h.

void sane_cancel (SANE_Handle h);
This function can be called at any time (as long as handle h is a valid handle) but usually affects long-running operations only (such as image is acquisition). It is safe to call this function asynchronously (e.g., from within a signal handler). It is important to note that completion of this operaton does not imply that the currently pending operation has been cancelled. It only guarantees that cancellation has been initiated. Cancellation completes only when the cancelled call returns (typically with a status value of SANE_STATUS_CANCELLED). Since the SANE API does not require any other operations to be re-entrant, this implies that a frontend must not call any other operation until the cancelled operation has returned.



MATSUBAYASHI 'Shaolin' Kohji 平成14年10月29日