开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 嵌入式/单片机编程 > VxWorks > 查看源码
usbHandleLib.h
资源名称：ixp425BSP.rar　[点击查看]
上传用户：luoyougen
上传日期：2008-05-12
资源大小：23136k
文件大小：3k
源码类别：

VxWorks

开发平台：

C/C++

usbHandleLib.h：源码内容
  1. /* usbHandleLib.h - handle utility functions */
  3. /* Copyright 2000 Wind River Systems, Inc. */
  5. /*
  6. Modification history
  7. --------------------
  8. 01f,18sep01,wef  merge from wrs.tor2_0.usb1_1-f for veloce
  9. 01e,07may01,wef  changed module number to be (module sub num << 8) | 
  10.  M_usbHostLib
  11. 01d,02may01,wef  changed module number to be M_<module> + M_usbHostLib
  12. 01c,05dec00,wef  moved Module number defs to vwModNum.h - add this 
  13.  to #includes
  14. 01b,07mar00,rcb  Change definition of GENERIC_HANDLE from UINT32 to
  15.  pVOID so handles can be compared against NULL without
  16.  generating warnings (e.g., on MIPS gnu toolchain).
  17. 01a,07jun99,rcb  First.
  18. */
  20. /*
  21. DESCRIPTION
  23. Defines a set of general-purpose handle creation and validation functions.
  25. Using these services, libraries can return handles to callers which can 
  26. subsequently be validated for authenticity.  This provides libraries with
  27. an additional measure of "bullet-proofing."
  28. */
  30. #ifndef __INCusbHandleLibh
  31. #define __INCusbHandleLibh
  33. #ifdef __cplusplus
  34. extern "C" {
  35. #endif
  37. /* includes */
  39. #include "usb/usbPlatform.h"  /* USB Module number def's */
  40. #include "vwModNum.h"  /* USB Module number def's */
  43. /* defines */
  45. /* Handle utility library return values */
  47. /* 
  48.  * USB errnos are defined as being part of the USB host Module, as are all
  49.  * vxWorks module numbers, but the USB Module number is further divided into 
  50.  * sub-modules.  Each sub-module has upto 255 values for its own error codes
  51.  */
  52.  
  53. #define USB_HANDLE_SUB_MODULE  3
  55. #define M_usbHandleLib  ( (USB_HANDLE_SUB_MODULE  << 8) | M_usbHostLib )
  57. #define hdlErr(x) (M_usbHandleLib | (x))
  59. #define S_usbHandleLib_OUT_OF_MEMORY     hdlErr(1)
  60. #define S_usbHandleLib_OUT_OF_RESOURCES     hdlErr(2)
  61. #define S_usbHandleLib_OUT_OF_HANDLES     hdlErr(3)
  62. #define S_usbHandleLib_BAD_PARAM     hdlErr(4)
  63. #define S_usbHandleLib_BAD_HANDLE     hdlErr(5)
  64. #define S_usbHandleLib_NOT_INITIALIZED     hdlErr(6)
  65. #define S_usbHandleLib_GENERAL_FAULT     hdlErr(7)
  68. /* typedefs */
  70. typedef pVOID GENERIC_HANDLE;     /* type of a generic handle */
  71. typedef GENERIC_HANDLE *pGENERIC_HANDLE;
  74. /* functions */
  76. STATUS usbHandleInitialize
  77.     (
  78.     UINT32 maxHandles     /* max handles allocated by library */
  79.     );
  82. STATUS usbHandleShutdown (void);
  85. STATUS usbHandleCreate
  86.     (
  87.     UINT32 handleSignature,     /* Arbitrary handle signature */
  88.     pVOID handleParam,     /* Arbitrary handle parameter */
  89.     pGENERIC_HANDLE pHandle     /* Newly allocated handle */
  90.     );
  93. STATUS usbHandleDestroy
  94.     (
  95.     GENERIC_HANDLE handle     /* handle to be destroyed */
  96.     );
  99. STATUS usbHandleValidate
  100.     (
  101.     GENERIC_HANDLE handle,     /* handle to be validated */
  102.     UINT32 handleSignature,     /* signature used to validate handle */
  103.     pVOID *pHandleParam      /* Handle parameter on return */
  104.     );
  107. #ifdef __cplusplus
  108. }
  109. #endif
  111. #endif /* __INCusbHandleLibh */
  114. /* End of file. */