source: mainline/uspace/lib/usbdev/include/usb/dev/request.h@ 33b8d024

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 33b8d024 was 33b8d024, checked in by Jiří Zárevúcky <zarevucky.jiri@…>, 7 years ago

Remove const qualifier from the argument of free() and realloc(),
as well as in numerous other variables that hold ownership of memory.

By convention, a pointer that holds ownership is _never_ qualified by const.
This is reflected in the standard type signature of free() and realloc().
Allowing const pointers to hold ownership may seem superficially convenient,
but is actually quite confusing to experienced C programmers.

  • Property mode set to 100644
File size: 3.9 KB
Line 
1/*
2 * Copyright (c) 2011 Vojtech Horky
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 *
9 * - Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * - Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
14 * - The name of the author may not be used to endorse or promote products
15 * derived from this software without specific prior written permission.
16 *
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 */
28
29/** @addtogroup libusbdev
30 * @{
31 */
32/** @file
33 * Standard USB requests.
34 */
35#ifndef LIBUSBDEV_REQUEST_H_
36#define LIBUSBDEV_REQUEST_H_
37
38#include <stddef.h>
39#include <stdint.h>
40#include <l18n/langs.h>
41#include <usb/usb.h>
42#include <usb/dev/pipes.h>
43#include <usb/descriptor.h>
44#include <usb/request.h>
45
46errno_t usb_control_request_set(usb_pipe_t *,
47 usb_request_type_t, usb_request_recipient_t, uint8_t,
48 uint16_t, uint16_t, const void *, size_t);
49
50errno_t usb_control_request_get(usb_pipe_t *,
51 usb_request_type_t, usb_request_recipient_t, uint8_t,
52 uint16_t, uint16_t, void *, size_t, size_t *);
53
54errno_t usb_request_get_status(usb_pipe_t *, usb_request_recipient_t,
55 uint16_t, uint16_t *);
56errno_t usb_request_clear_feature(usb_pipe_t *, usb_request_type_t,
57 usb_request_recipient_t, uint16_t, uint16_t);
58errno_t usb_request_set_feature(usb_pipe_t *, usb_request_type_t,
59 usb_request_recipient_t, uint16_t, uint16_t);
60errno_t usb_request_get_descriptor(usb_pipe_t *, usb_request_type_t,
61 usb_request_recipient_t, uint8_t, uint8_t, uint16_t, void *, size_t,
62 size_t *);
63errno_t usb_request_get_descriptor_alloc(usb_pipe_t *, usb_request_type_t,
64 usb_request_recipient_t, uint8_t, uint8_t, uint16_t, void **, size_t *);
65errno_t usb_request_get_device_descriptor(usb_pipe_t *,
66 usb_standard_device_descriptor_t *);
67errno_t usb_request_get_bare_configuration_descriptor(usb_pipe_t *, int,
68 usb_standard_configuration_descriptor_t *);
69errno_t usb_request_get_full_configuration_descriptor(usb_pipe_t *, int,
70 void *, size_t, size_t *);
71errno_t usb_request_get_full_configuration_descriptor_alloc(usb_pipe_t *,
72 int, void **, size_t *);
73errno_t usb_request_set_descriptor(usb_pipe_t *, usb_request_type_t,
74 usb_request_recipient_t, uint8_t, uint8_t, uint16_t, const void *, size_t);
75
76errno_t usb_request_get_configuration(usb_pipe_t *, uint8_t *);
77errno_t usb_request_set_configuration(usb_pipe_t *, uint8_t);
78
79errno_t usb_request_get_interface(usb_pipe_t *, uint8_t, uint8_t *);
80errno_t usb_request_set_interface(usb_pipe_t *, uint8_t, uint8_t);
81
82errno_t usb_request_get_supported_languages(usb_pipe_t *,
83 l18_win_locales_t **, size_t *);
84errno_t usb_request_get_string(usb_pipe_t *, size_t, l18_win_locales_t,
85 char **);
86
87errno_t usb_request_clear_endpoint_halt(usb_pipe_t *, uint16_t);
88errno_t usb_pipe_clear_halt(usb_pipe_t *, usb_pipe_t *);
89errno_t usb_request_get_endpoint_status(usb_pipe_t *, usb_pipe_t *, uint16_t *);
90
91#endif
92/**
93 * @}
94 */
Note: See TracBrowser for help on using the repository browser.