host_cnl.c
2.4 KB
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
/*HEADER******************************************************************
**************************************************************************
***
*** Copyright (c) 2001-2002 ARC International.
*** All rights reserved
***
*** This software embodies materials and concepts which are
*** confidential to ARC International and is made
*** available solely pursuant to the terms of a written license
*** agreement with ARC International
***
*** File: hostapi.c
***
*** Comments:
*** This file contains the USB Host API specific functions.
***
**************************************************************************
*END*********************************************************************/
#include "os_bb.h"
#include "osint.h"
/*FUNCTION*-------------------------------------------------------------
*
* Function Name : _usb_host_cancel_transfer
* Returned Value : error or status of the transfer before cancellation
* Comments :
* _usb_host_cancel_transfer is a non-blocking routine that causes a transfer to
* be terminated.
*
*END*-----------------------------------------------------------------*/
uint_8 _usb_host_cancel_transfer
(
/* [IN] the USB Host state structure */
_usb_host_handle handle,
/* Index into the Pipe Descriptor Array */
int_16 pipeid
)
{ /* Body */
uint_8 bRet;
PIPE_DESCRIPTOR_STRUCT_PTR pipe_descr_ptr;
USB_HOST_STATE_STRUCT_PTR usb_host_ptr;
usb_host_ptr = (USB_HOST_STATE_STRUCT_PTR)handle;
/* Check if valid pipe id */
if (pipeid < usb_host_ptr->MAX_PIPES) {
pipe_descr_ptr = &usb_host_ptr->PIPE_DESCRIPTOR_BASE_PTR[pipeid];
} else {
return USBERR_INVALID_PIPE_ID;
} /* Endif */
/* Get the current status */
bRet = pipe_descr_ptr->STATUS;
_usb_hci_vusb11_cancel_transfer(handle, pipe_descr_ptr);
/* Indicate that a transfer is not pending */
pipe_descr_ptr->PACKETPENDING = FALSE;
/* Indicate that the pipe is idle */
pipe_descr_ptr->STATUS = USB_STATUS_IDLE;
/* Update the head of the queue for a particular type */
_usb_host_update_current_head(handle, pipe_descr_ptr->PIPETYPE);
/* Return the status prior to the transfer cancellation */
return bRet;
} /* Endbody */