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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
/***************************************************************************
* Copyright (c) 2024 Microsoft Corporation
* Copyright (c) 2026-present Eclipse ThreadX contributors
*
* This program and the accompanying materials are made available under the
* terms of the MIT License which is available at
* https://opensource.org/licenses/MIT.
*
* SPDX-License-Identifier: MIT
**************************************************************************/
/**************************************************************************/
/**************************************************************************/
/** */
/** USBX Component */
/** */
/** Host Data Pump Class */
/** */
/**************************************************************************/
/**************************************************************************/
/* Include necessary system files. */
#define UX_SOURCE_CODE
#include "ux_api.h"
#include "ux_host_class_dpump.h"
#include "ux_host_stack.h"
/**************************************************************************/
/* */
/* FUNCTION RELEASE */
/* */
/* _ux_host_class_dpump_ioctl PORTABLE C */
/* 6.1.12 */
/* AUTHOR */
/* */
/* Chaoqiong Xiao, Microsoft Corporation */
/* */
/* DESCRIPTION */
/* */
/* This function is called by the application to change the alternate */
/* setting of the dpump class. */
/* */
/* INPUT */
/* */
/* dpump Pointer to the dpump class */
/* ioctl_function ioctl function */
/* parameter pointer to structure */
/* */
/* */
/* OUTPUT */
/* */
/* Completion Status */
/* */
/* CALLS */
/* */
/* _ux_host_stack_interface_setting_select */
/* Select alternate setting */
/* */
/* CALLED BY */
/* */
/* */
/**************************************************************************/
UINT _ux_host_class_dpump_ioctl(UX_HOST_CLASS_DPUMP *dpump, ULONG ioctl_function,
VOID *parameter)
{
UX_CONFIGURATION *configuration;
UX_INTERFACE *interface_ptr;
UINT status;
/* Ensure the instance is valid. */
if ((dpump -> ux_host_class_dpump_state != UX_HOST_CLASS_INSTANCE_LIVE) &&
(dpump -> ux_host_class_dpump_state != UX_HOST_CLASS_INSTANCE_MOUNTING))
{
/* Error trap. */
_ux_system_error_handler(UX_SYSTEM_LEVEL_THREAD, UX_SYSTEM_CONTEXT_CLASS, UX_HOST_CLASS_INSTANCE_UNKNOWN);
/* If trace is enabled, insert this event into the trace buffer. */
UX_TRACE_IN_LINE_INSERT(UX_TRACE_ERROR, UX_HOST_CLASS_INSTANCE_UNKNOWN, dpump, 0, 0, UX_TRACE_ERRORS, 0, 0)
return(UX_HOST_CLASS_INSTANCE_UNKNOWN);
}
/* The command request will tell us we need to do here. */
switch (ioctl_function)
{
case UX_HOST_CLASS_DPUMP_SELECT_ALTERNATE_SETTING:
/* The parameter value has the alternate setting number.
We need to scan the entire device framework. Only one configuration for data pump device framework. */
interface_ptr = dpump -> ux_host_class_dpump_interface;
configuration = interface_ptr -> ux_interface_configuration;
/* Do some verification just in case ! */
if (configuration == UX_NULL)
{
/* Error trap. */
_ux_system_error_handler(UX_SYSTEM_LEVEL_THREAD, UX_SYSTEM_CONTEXT_CLASS, UX_HOST_CLASS_INSTANCE_UNKNOWN);
return(UX_HOST_CLASS_INSTANCE_UNKNOWN);
}
/* Point to the first interface. */
interface_ptr = configuration -> ux_configuration_first_interface;
/* Loop on all interfaces and alternate settings for this device in search of the right alternate setting. */
while (interface_ptr != UX_NULL)
{
/* Check the alternate setting. */
if (interface_ptr -> ux_interface_descriptor.bAlternateSetting == (ULONG) (ALIGN_TYPE) parameter)
{
/* We have found the alternate setting. Select it now. */
status = _ux_host_stack_interface_setting_select(interface_ptr);
/* We are done here. */
return(status);
}
/* Next interface. */
interface_ptr = interface_ptr -> ux_interface_next_interface;
}
/* We come here when the alternate setting was not found. */
status = UX_INTERFACE_HANDLE_UNKNOWN;
/* Error trap. */
_ux_system_error_handler(UX_SYSTEM_LEVEL_THREAD, UX_SYSTEM_CONTEXT_CLASS, status);
break;
default:
/* If trace is enabled, insert this event into the trace buffer. */
UX_TRACE_IN_LINE_INSERT(UX_TRACE_ERROR, UX_FUNCTION_NOT_SUPPORTED, 0, 0, 0, UX_TRACE_ERRORS, 0, 0)
/* Function not supported. Return an error. */
status = UX_FUNCTION_NOT_SUPPORTED;
/* Error trap. */
_ux_system_error_handler(UX_SYSTEM_LEVEL_THREAD, UX_SYSTEM_CONTEXT_CLASS, status);
}
/* Return status to caller. */
return(status);
}
|
