blob: 0d84328f3eb73b7c9cb948dcb01bd3d10628b4f7 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
// Copyright 2014 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef DEVICE_USB_USB_DEVICE_H_
#define DEVICE_USB_USB_DEVICE_H_
#include "base/basictypes.h"
#include "base/callback.h"
#include "base/memory/ref_counted.h"
#include "base/strings/string16.h"
namespace device {
class UsbDeviceHandle;
struct UsbConfigDescriptor;
// A UsbDevice object represents a detected USB device, providing basic
// information about it. Methods other than simple property accessors must be
// called from the thread on which this object was created. For further
// manipulation of the device, a UsbDeviceHandle must be created from Open()
// method.
class UsbDevice : public base::RefCountedThreadSafe<UsbDevice> {
public:
using OpenCallback = base::Callback<void(scoped_refptr<UsbDeviceHandle>)>;
using ResultCallback = base::Callback<void(bool success)>;
// A unique identifier which remains stable for the lifetime of this device
// object (i.e., until the device is unplugged or the USB service dies.)
const std::string& guid() const { return guid_; }
// Accessors to basic information.
uint16 vendor_id() const { return vendor_id_; }
uint16 product_id() const { return product_id_; }
const base::string16& manufacturer_string() const {
return manufacturer_string_;
}
const base::string16& product_string() const { return product_string_; }
const base::string16& serial_number() const { return serial_number_; }
// On ChromeOS the permission_broker service is used to change the ownership
// of USB device nodes so that Chrome can open them. On other platforms these
// functions are no-ops and always return true.
virtual void CheckUsbAccess(const ResultCallback& callback);
// Creates a UsbDeviceHandle for further manipulation.
virtual void Open(const OpenCallback& callback) = 0;
// Creates a UsbDeviceHandle for further manipulation. This method is a
// temporary workaround for crbug.com/500057 while the work to finish
// crbug.com/496469 is completed.
virtual void OpenInterface(int interface_id, const OpenCallback& callback);
// Explicitly closes a device handle. This method will be automatically called
// by the destructor of a UsbDeviceHandle as well.
virtual bool Close(scoped_refptr<UsbDeviceHandle> handle) = 0;
// Gets the UsbConfigDescriptor for the active device configuration or nullptr
// if the device is unconfigured.
virtual const UsbConfigDescriptor* GetConfiguration() = 0;
protected:
UsbDevice(uint16 vendor_id,
uint16 product_id,
const base::string16& manufacturer_string,
const base::string16& product_string,
const base::string16& serial_number);
virtual ~UsbDevice();
// These members must be mutable by subclasses as necessary during device
// enumeration. To preserve the thread safety of this object they must remain
// constant afterwards.
base::string16 manufacturer_string_;
base::string16 product_string_;
base::string16 serial_number_;
private:
friend class base::RefCountedThreadSafe<UsbDevice>;
const std::string guid_;
const uint16 vendor_id_;
const uint16 product_id_;
DISALLOW_COPY_AND_ASSIGN(UsbDevice);
};
} // namespace device
#endif // DEVICE_USB_USB_DEVICE_H_
|