usb_pipe_get_max_bulk_transfer_size(9f)

1usb_pipe_get_max_bulk_tranKsefrenre_lsiFzuen(c9tFi)onussbf_opripDer_igveetr_smax_bulk_transfer_size(9F)
2
3
4

NAME

6       usb_pipe_get_max_bulk_transfer_size - Get maximum bulk transfer size
7

SYNOPSIS

9       #include <sys/usb/usba.h>
10
11
12
13       int usb_pipe_get_max_bulk_transfer_size(dev_info_t dip, size_t *size);
14
15

INTERFACE LEVEL

17       Solaris DDI specific (Solaris DDI)
18

PARAMETERS

20       dip     Pointer to the device's dev_info structure.
21
22
23       size    Returns the bulk transfer size.
24
25

DESCRIPTION

27       The  usb_pipe_get_max_bulk_transfer_size() function returns the maximum
28       data transfer size in bytes that the host controller driver can support
29       per  bulk  request. This information can be used to limit or break down
30       larger requests to manageable sizes.
31

RETURN VALUES

33       USB_SUCCESS         Size is returned in size argument.
34
35
36       USB_INVALID_ARGS    dip and/or size argument is NULL.
37
38
39       USB_FAILURE         Size could not be returned.  Zero  is  returned  in
40                           size arg.
41
42

CONTEXT

44       May be called from user, kernel or interrupt context.
45

EXAMPLES

47             int xxx_attach(dev_info_t *dip, int command)
48             {
49                    ...
50                    usb_pipe_get_max_bulk_transfer_size(dip, &state>max_xfer_size);
51                    ...
52             }
53
54             void xxx_minphys(struct buf bp)
55             {
56                    ...
57                    if (bp->b_bcount > state->max_xfer_size) {
58                            bp->b_bcount = state->max_xfer_size;
59                    }
60                    ...
61             }
62
63
64
65

ATTRIBUTES

67       See attributes(5) for descriptions of the following attributes:
68
69
70
71
72       ┌─────────────────────────────┬─────────────────────────────┐
73       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
74       ├─────────────────────────────┼─────────────────────────────┤
75       │Architecture                 │PCI-based systems            │
76       ├─────────────────────────────┼─────────────────────────────┤
77       │Interface stability          │Committed                    │
78       ├─────────────────────────────┼─────────────────────────────┤
79       │Availability                 │SUNWusb                      │
80       └─────────────────────────────┴─────────────────────────────┘
81