| Debugging Tools for Windows |
When you debug Plug and Play drivers, you may find the following debugger extensions useful.
Displays the current system resource arbiters. An arbiter is a piece of code that is exposed by the bus driver that arbitrates requests for resources, and attempts to solve the resource conflicts among the devices connected on that bus.
Displays the CM_RESOURCE_LIST for the specified device object.
You must know the address of the CM Resource List.
Here is an example:
CmResourceList at 0xe12576e8 Version 0.0 Interface 0x1 Bus #0
Entry 0 - Port (0x1) Device Exclusive (0x1)
Flags (0x01) - PORT_MEMORY PORT_IO
Range starts at 0x3f8 for 0x8 bytes
Entry 1 - Interrupt (0x2) Shared (0x3)
Flags (0x01) - LATCHED
Level 0x4, Vector 0x4, Affinity 0xffffffff
This shows that the device with this CM resource list is using I/O Range 3F8-3FF and IRQ 4.
This extension is obsolete — its functionality has been subsumed by !pci. See the !pci 100 example later in this section.
Displays bus-specific device extension information for a variety of devices.
Displays information about a node in the device tree.
Device node 0 (zero) is the root of the device tree.
Here is an example:
DevNode 0xff0d4a08 for PDO 0xff0d4af0 at level 0
Parent 0xff0daf48 Sibling 0xff0d4848 Child 0000000000
InterfaceType 0xffffffff Bus Number 0xfffffff0
InstancePath is "Root\*PNP0501\PnPBIOS_2"
ServiceName is "Serial"
TargetDeviceNotify List - f 0xff0d4a6c b 0xff0d4a6c
Flags (0x6000122b) DNF_PROCESSED, DNF_STARTED,
DNF_ENUMERATED, DNF_MADEUP,
DNF_RESOURCE_ASSIGNED, DNF_ADDED,
DNF_HAS_BOOT_CONFIG
Unknown flags 0x40000000
Displays detailed information about a DEVICE_OBJECT.
Here is an example:
Device object (ff0d4af0) is for:
00252d \Driver\PnpManager DriverObject ff0d9030
Current Irp 00000000 RefCount 0 Type 00000004 Flags 00001040AttachedDev ff0b59e0
DevExt ff0d4ba8 DevNode ff0d4a08
Device queue is not busy.
The !drivers command is no longer supported. Please use the lm t n command instead.
Displays detailed information about a DRIVER_OBJECT.
Lists all the device objects created by the specified driver.
Here is an example:
Driver object (ff0ba630) is for:
\Driver\Serial
Driver Extension List: (id , addr)
Device Object list:
ffba3040 ff0b4040 ff0b59e0 ff0b5040
(x86 target computers only) Writes a sequence of values into the PCI configuration space.
Reads data from an I/O port.
These three commands are useful for determining whether a certain I/O range is claimed by a device other than the driver being debugged. A byte value of 0xFF at a port indicates that the port is not in use.
Displays the specified IO_RESOURCE_REQUIREMENTS_LIST.
Displays information about an IRP.
Displays information about all IRPs currently allocated in the target system, or information about those IRPs whose fields match the specified search criteria.
(x86 target computers only) Displays the current status of the PCI buses and any devices attached to them. It can also display the PCI configuration space.
The following example displays the devices on the primary bus:
PCI Bus 0
00:0 8086:1237.02 Cmd[0106:.mb..s] Sts[2280:.....] Device Host bridge
0d:0 8086:7000.01 Cmd[0007:imb...] Sts[0280:.....] Device ISA bridge
0d:1 8086:7010.00 Cmd[0005:i.b...] Sts[0280:.....] Device IDE controller
0e:0 1011:0021.01 Cmd[0107:imb..s] Sts[0280:.....] PciBridge 0->1-1 PCI-PCI
bridge
10:0 5333:8811.43 Cmd[0023:im.v..] Sts[0200:.....] Device VGA compatible controller
The following example displays the devices for the secondary bus, with verbose output:
PCI Bus 1
08:0 10b7:5900.00 Cmd[0107:imb..s] Sts[0200:.....] Device Ethernet
cf8:80014000 IntPin:1 IntLine:f Rom:fa000000 cis:0 cap:0
IO[0]:fce1
09:0 9004:8178.00 Cmd[0117:imb..s] Sts[0280:.....] Device SCSI controller
cf8:80014800 IntPin:1 IntLine:f Rom:fa000000 cis:0 cap:0
IO[0]:f801 MEM[1]:f9fff000
0b:0 9004:5800.10 Cmd[0116:.mb..s] Sts[0200:.....] Device SubID:9004:8940
1394 host controller
cf8:80015800 IntPin:1 IntLine:e Rom:fa000000 cis:0 cap:0
MEM[0]:f9ffec00
The following example displays the PCI configuration space for the SCSI controller (bus 1, device 9, function 0):
00: 9004 ;VendorID=9004
02: 8178 ;DeviceID=8178
04: 0117 ;Command=SERREnable,MemWriteEnable,BusInitiate,MemSpaceEnable,IOSpac
eEnable
06: 0280 ;Status=FB2BCapable,DEVSELTiming:1
08: 00 ;RevisionID=00
09: 00 ;ProgIF=00 (SCSI bus controller)
0a: 00 ;SubClass=00
0b: 01 ;BaseClass=01 (Mass storage controller)
0c: 08 ;CacheLineSize=Burst8DW
0d: 20 ;LatencyTimer=20
0e: 00 ;HeaderType=00
0f: 00 ;BIST=00
10: 0000f801;BAR0=0000f801
14: f9fff000;BAR1=f9fff000
18: 00000000;BAR2=00000000
1c: 00000000;BAR3=00000000
20: 00000000;BAR4=00000000
24: 00000000;BAR5=00000000
28: 00000000;CBCISPtr=00000000
2c: 0000 ;SubSysVenID=0000
2e: 0000 ;SubSysID=0000
30: fa000000;ROMBAR=fa000000
34: 00000000;Reserved=00000000
38: 00000000;Reserved=00000000
3c: 0f ;IntLine=0f
3d: 01 ;IntPin=01
3e: 08 ;MinGnt=08
3f: 08 ;MaxLat=08
40: 00001580,00001580,00000000,00000000,00000000,00000000,00000000,00000000
60: 00000000,00000000,00000000,00000000,00000000,00000000,00000000,00000000
80: 00000000,00000000,00000000,00000000,00000000,00000000,00000000,00000000
a0: 00000000,00000000,00000000,00000000,00000000,00000000,00000000,00000000
c0: 00000000,00000000,00000000,00000000,00000000,00000000,00000000,00000000
e0: 00000000,00000000,00000000,00000000,00000000,00000000,00000000,00000000
Displays information about PCI device objects, including child PCI buses and CardBus buses, as well as the devices attached to them.
Displays the PnP device event queue.
Displays a PnP relation list and any related CM_RESOURCE_LIST and IO_RESOURCE_LIST structures.