Win2000通用USB主机控制器库usbd.sys

usbd简介

Win2000支持的主uhci和ohci，两都都支持usb1.1，只是实现方式不同而已。但是对于不同的主机控制器实现方式，肯定会有很多通用的代码，微软将其其静态库的方式存入内核，这样无论是开发uhci还是ohci主机USB控制器程序，只需要链接usbd通用代码即可。

• 对于uhci,其完整的主机控制驱动程序为uhci mini小端口驱动和usbd.sys
• 对于ohci,其完整的主机控制驱动程序为ohci mini小端口驱动和usbd.sys

  所以usbd.sys类似disk.sys，是类驱动程序

usb导出库

由于usbd是类驱动程序，所以其就和应用层的dll一样，负责导出通用库函数。

LIBRARY     USBD.SYS

EXPORTS
    USBD_AllocateDeviceName
    USBD_CalculateUsbBandwidth
    USBD_CompleteRequest
    USBD_CreateConfigurationRequest
    USBD_CreateDevice
    USBD_Debug_GetHeap
    USBD_Debug_LogEntry
    USBD_Debug_RetHeap
    USBD_Dispatch
    USBD_FreeDeviceMutex
    USBD_FreeDeviceName
    USBD_GetDeviceInformation
    USBD_GetInterfaceLength
    USBD_GetPdoRegistryParameter
    USBD_GetSuspendPowerState
    USBD_GetUSBDIVersion
    USBD_InitializeDevice
    USBD_MakePdoName
    USBD_ParseConfigurationDescriptor
    USBD_QueryBusTime
    USBD_RegisterHcDeviceCapabilities
    USBD_RegisterHcFilter
    USBD_RegisterHostController
    USBD_RemoveDevice
    USBD_RestoreDevice
    USBD_SetSuspendPowerState
    USBD_WaitDeviceMutex
#if defined(_X86_) && !defined(NO_DEF_ALIAS)
    _USBD_CreateConfigurationRequestEx@8 //导出原始 stdcall 符号
    _USBD_ParseConfigurationDescriptorEx@28
    _USBD_ParseDescriptors@16
    USBD_CreateConfigurationRequestEx=_USBD_CreateConfigurationRequestEx@8 //创建别名映射
    USBD_ParseConfigurationDescriptorEx=_USBD_ParseConfigurationDescriptorEx@28
    USBD_ParseDescriptors=_USBD_ParseDescriptors@16
#else
    USBD_CreateConfigurationRequestEx
    USBD_ParseConfigurationDescriptorEx
    USBD_ParseDescriptors
#endif
    DllInitialize   PRIVATE
    DllUnload       PRIVATE

可以看到，有三个函数会根据宏的不同，导出的名字不一样，带stdcall的别名或者和其它函数一样，不带别名。
这三个函数之所以有所不同，完全是因为调用者身份不同而因起的。
在 x86 的 stdcall 调用约定中：编译器自动添加 _FunctionName@N 后缀，N 为参数字节数

• 当仅为该模块内部使用时，不需要stdcall的别名
• 当被其它模块如驱动链接进入时，需要stdcall别名。这里其实使用了Ex扩展别名映射，

调用者视角：

// 用户代码可以使用简洁的函数名
PURB urb = USBD_CreateConfigurationRequestEx(configDesc, ifaceList);

链接器视角：

USBD_CreateConfigurationRequestEx → _USBD_CreateConfigurationRequestEx@8

这些导出的函数功能如下：

函数分类统计