1 /**************************************************************************/
2 /*                                                                        */
3 /*       Copyright (c) Microsoft Corporation. All rights reserved.        */
4 /*                                                                        */
5 /*       This software is licensed under the Microsoft Software License   */
6 /*       Terms for Microsoft Azure RTOS. Full text of the license can be  */
7 /*       found in the LICENSE file at https://aka.ms/AzureRTOS_EULA       */
8 /*       and in the root directory of this software.                      */
9 /*                                                                        */
10 /**************************************************************************/
11 
12 
13 /**************************************************************************/
14 /**************************************************************************/
15 /**                                                                       */
16 /** USBX Component                                                        */
17 /**                                                                       */
18 /**   Video Class                                                         */
19 /**                                                                       */
20 /**************************************************************************/
21 /**************************************************************************/
22 
23 
24 /* Include necessary system files.  */
25 
26 #define UX_SOURCE_CODE
27 
28 #include "ux_api.h"
29 #include "ux_host_class_video.h"
30 #include "ux_host_stack.h"
31 
32 
33 /**************************************************************************/
34 /*                                                                        */
35 /*  FUNCTION                                               RELEASE        */
36 /*                                                                        */
37 /*    _ux_host_class_video_transfer_request_completed     PORTABLE C      */
38 /*                                                           6.1          */
39 /*  AUTHOR                                                                */
40 /*                                                                        */
41 /*    Chaoqiong Xiao, Microsoft Corporation                               */
42 /*                                                                        */
43 /*  DESCRIPTION                                                           */
44 /*                                                                        */
45 /*    This function receives a completion call back on an isoch transfer  */
46 /*    request.                                                            */
47 /*                                                                        */
48 /*  INPUT                                                                 */
49 /*                                                                        */
50 /*    transfer_request                      Pointer to transfer request   */
51 /*                                                                        */
52 /*  OUTPUT                                                                */
53 /*                                                                        */
54 /*    None                                                                */
55 /*                                                                        */
56 /*  CALLS                                                                 */
57 /*                                                                        */
58 /*    (ux_host_class_video_transfer_request_completion_function)          */
59 /*                                          Transfer request completion   */
60 /*                                                                        */
61 /*  CALLED BY                                                             */
62 /*                                                                        */
63 /*    Video Class                                                         */
64 /*                                                                        */
65 /*  RELEASE HISTORY                                                       */
66 /*                                                                        */
67 /*    DATE              NAME                      DESCRIPTION             */
68 /*                                                                        */
69 /*  05-19-2020     Chaoqiong Xiao           Initial Version 6.0           */
70 /*  09-30-2020     Chaoqiong Xiao           Modified comment(s),          */
71 /*                                            resulting in version 6.1    */
72 /*                                                                        */
73 /**************************************************************************/
_ux_host_class_video_transfer_request_completed(UX_TRANSFER * transfer_request)74 VOID  _ux_host_class_video_transfer_request_completed(UX_TRANSFER *transfer_request)
75 {
76 
77 UX_HOST_CLASS_VIDEO_TRANSFER_REQUEST     *video_transfer_request;
78 
79 
80     /* Get the pointer to the video specific transfer request, by nature of the lined transfer requests,
81        the corresponding transfer request has to be the head transfer request in the video instance.  */
82     video_transfer_request =  (UX_HOST_CLASS_VIDEO_TRANSFER_REQUEST *) transfer_request -> ux_transfer_request_user_specific;
83 
84     /* Do a sanity check on the transfer request, if NULL something is wrong.  */
85     if (video_transfer_request == UX_NULL)
86         return;
87 
88     /* The caller's transfer request needs to be updated.  */
89     video_transfer_request -> ux_host_class_video_transfer_request_actual_length =    transfer_request -> ux_transfer_request_actual_length;
90     video_transfer_request -> ux_host_class_video_transfer_request_completion_code =  transfer_request -> ux_transfer_request_completion_code;
91 
92     /* Call the completion routine.  */
93     video_transfer_request -> ux_host_class_video_transfer_request_completion_function(video_transfer_request);
94 
95     /* Return to caller.  */
96     return;
97 }
98 
99