kopia lustrzana https://gitlab.com/sane-project/backends
74 wiersze
3.0 KiB
C
74 wiersze
3.0 KiB
C
|
/* sane - Scanner Access Now Easy.
|
||
|
|
Copyright (C) 2001 Henning Meier-Geinitz
|
||
|
|
This file is part of the SANE package.
|
||
|
|
|
||
|
|
SANE is free software; you can redistribute it and/or modify it
|
||
|
|
under the terms of the GNU General Public License as published by
|
||
|
|
the Free Software Foundation; either version 2 of the License, or
|
||
|
|
(at your option) any later version.
|
||
|
|
|
||
|
|
SANE is distributed in the hope that it will be useful, but WITHOUT
|
||
|
|
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
|
||
|
|
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
|
||
|
|
License for more details.
|
||
|
|
|
||
|
|
You should have received a copy of the GNU General Public License
|
||
|
|
along with sane; see the file COPYING. If not, write to the Free
|
||
|
|
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
||
|
|
|
||
|
|
This file provides a generic USB interface. */
|
||
|
|
|
||
|
|
#ifndef sanei_usb_h
|
||
|
|
#define sanei_usb_h
|
||
|
|
|
||
|
|
#include "../include/sane/config.h"
|
||
|
|
#include "../include/sane/sane.h"
|
||
|
|
|
||
|
|
/* Initialize sanei_usb. Call this before any other sanei_usb function */
|
||
|
|
void
|
||
|
|
sanei_usb_init (void);
|
||
|
|
|
||
|
|
/* Get the vendor and product numbers for a given file descriptor. Currently,
|
||
|
|
only scanners supported by the Linux USB scanner module can be found. Linux
|
||
|
|
version must be 2.4.8 or higher. Returns SANE_STATUS_GOOD if the ids have
|
||
|
|
been found, otherwise SANE_STATUS_UNSUPPORTED. */
|
||
|
|
SANE_Status
|
||
|
|
sanei_usb_get_vendor_product (SANE_Int fd, SANE_Word * vendor,
|
||
|
|
SANE_Word * product);
|
||
|
|
|
||
|
|
/* Find device names for given vendor and product ids. Above mentioned
|
||
|
|
limitations apply. The function attach is called for every device which
|
||
|
|
has been found.*/
|
||
|
|
SANE_Status
|
||
|
|
sanei_usb_find_devices (SANE_Int vendor, SANE_Int product,
|
||
|
|
SANE_Status (*attach) (SANE_String_Const devname));
|
||
|
|
|
||
|
|
/* Open an USB device using it's device file. Return a file descriptor. On
|
||
|
|
success, SANE_STATUS_GOOD is returned. If the file couldn't be accessed
|
||
|
|
due to permissions, SANE_STATUS_ACCESS_DENIED is returned. For every
|
||
|
|
other error, the return value is SANE_STATUS_INVAL. */
|
||
|
|
SANE_Status
|
||
|
|
sanei_usb_open (SANE_String_Const devname, SANE_Int *fd);
|
||
|
|
|
||
|
|
/* Close an USB device represented by its file desciptor. */
|
||
|
|
void
|
||
|
|
sanei_usb_close (SANE_Int fd);
|
||
|
|
|
||
|
|
/* Initiate a bulk transfer read of up to zize bytes from the device to
|
||
|
|
buffer. After the read, size contains the number of bytes actually
|
||
|
|
read. Returns SANE_STATUS_GOOD on succes, SANE_STATUS_EOF if zero bytes
|
||
|
|
have been read, SANE_STATUS_IO_ERROR if an error occured during the read,
|
||
|
|
and SANE_STATUS_INVAL on every other error. */
|
||
|
|
SANE_Status
|
||
|
|
sanei_usb_read_bulk (SANE_Int fd, SANE_Byte * buffer, size_t *size);
|
||
|
|
|
||
|
|
/* Initiate a bulk transfer write of up to size bytes from buffer to the
|
||
|
|
device. After the write size contains the number of bytes actually
|
||
|
|
written. Returns SANE_STATUS_GOOD on succes, SANE_STATUS_IO_ERROR if an
|
||
|
|
error occured during the read, and SANE_STATUS_INVAL on every other
|
||
|
|
error. */
|
||
|
|
SANE_Status
|
||
|
|
sanei_usb_write_bulk (SANE_Int fd, SANE_Byte * buffer, size_t *size);
|
||
|
|
|
||
|
|
#endif /* sanei_usb_h */
|