Edit

!usbkd.usblist

  • Article

The !usbkd.usblist command displays a linked list of structures of a specified type.

!usbkd.usblist ListAddr, ListType

Parameters

ListAddr
Address of a linked list of structures. To find addresses of linked lists maintained by the USB port driver, use !usbhcdext. To find addresses of linked list maintained by the USB hub driver, use !usbhubext.

ListType
One of the following list types.

List type Structure
BC usbport!_BUS_CONTEXT
EP usbport!_HCD_ENDPOINT
TT usbport!_TRANSACTION_TRANSLATOR
DL usbport!_USBD_DEVICE_HANDLE
PL usbhub!_DEVICE_EXTENSION_PDO
EL usbhub!_HUB_EXCEPTION_RECORD
RL usbhub!_HUB_REFERENCE_LIST_ENTRY
TL usbhub!_HUB_TIMER_OBJECT
WI usbhub!_HUB_WORKITEM
IO usbhub!_IO_LIST_ENTRY
LA usbhub!_LATCH_LIST_ENTRY
CL usbhub!_PORT_CHANGE_CONTEXT
BL usbhub!_SSP_BUSY_HANDLE

DLL

Usbkd.dll

Examples

Here is one way to find the address of a linked list. First enter !usbkd.usb2tree.

0: kd> !usbkd.usb2tree
...
2)!ehci_info ffffe00001ca11a0 !devobj ffffe00001ca1050 ...
   ...

In the preceding output, the address of the device extension of the FDO is displayed as the argument of the DML command !ehci_info ffffe00001ca11a0.

Either click the DML command or pass the address of the device extension to !usbhcdext.

0: kd> !usbkd.usbhcdext ffffe00001ca11a0

HC Flavor 1000  FDO ffffe00001ca1050
Root Hub: FDO ffffe00002320050 !hub2_info ffffe000023201a0
...
DeviceHandleList: !usblist ffffe00001ca23b8, DL
...

In the preceding output, ffffe00001ca23b8 is the address of a linked list of usbport!_USBD_DEVICE_HANDLE structures.

Now pass the address of the linked list to !usblist.

0: kd> !usblist ffffe00001ca23b8, DL
list: ffffe00001ca23b8 DL
----------
!usbdevh ffffe000020f9590
SSP [IdleReady] (0)
PCI\VEN_Xxxx  Xxxx Corporation
Root Hub
DriverName :  
----------
!usbdevh ffffe00001bce250
SSP [IdleReady] (0)
USB\Xxxx  Xxxx Corporation
Speed: HIGH, Address:  1, PortPathDepth: 1, PortPath: [3 0 0 0 0 0]
DriverName :\Driver\USBSTOR      !devstack ffffe000053ef2a0
----------

See also

USB 2.0 Debugger Extensions

Universal Serial Bus (USB) Drivers