Table of Contents
© 2018 Jungo Connectivity Ltd. iv CONFIDENTIAL
3.5.1. Windows WinDriver Uninstall Instructions ....................................................... 23
3.5.2. Linux WinDriver Uninstall Instructions ............................................................. 25
4. Using DriverWizard .................................................................................................................. 26
4.1. An Overview .................................................................................................................. 26
4.2. DriverWizard Walkthrough ........................................................................................... 27
4.2.1. Automatic Code Generation ............................................................................... 34
4.2.1.1. Generating the Code ................................................................................ 34
4.2.1.2. The Generated PCI/ISA C Code ............................................................. 34
4.2.2. Compiling the Generated Code .......................................................................... 35
4.2.2.1. Windows Compilation ............................................................................. 35
4.2.2.2. Linux Compilation ................................................................................... 36
5. Developing a Driver ................................................................................................................. 37
5.1. Using DriverWizard to Build a Device Driver ............................................................. 37
5.2. Writing the Device Driver Without DriverWizard ........................................................ 38
5.2.1. Include the Required WinDriver Files ............................................................... 38
5.2.2. Write Your Code ................................................................................................ 39
5.2.3. Configure and Build Your Code ........................................................................ 39
6. Debugging Drivers .................................................................................................................... 41
6.1. User-Mode Debugging .................................................................................................. 41
6.2. Debug Monitor ............................................................................................................... 41
6.2.1. The wddebug_gui Utility .................................................................................... 42
6.2.1.1. Search in wddebug_gui ........................................................................... 45
6.2.1.2. Opening Windows kernel crash dump with wddebug_gui ...................... 46
6.2.1.3. Running wddebug_gui for a Renamed Driver ......................................... 46
6.2.2. The wddebug Utility ........................................................................................... 46
6.2.2.1. Console-Mode wddebug Execution ......................................................... 46
7. Enhanced Support for Specific Chipsets .................................................................................. 50
7.1. Overview ........................................................................................................................ 50
7.2. Developing a Driver Using the Enhanced Chipset Support .......................................... 50
8. PCI Express .............................................................................................................................. 52
8.1. PCI Express Overview .................................................................................................. 52
8.2. WinDriver for PCI Express ........................................................................................... 53
9. Advanced Issues ....................................................................................................................... 54
9.1. Performing Direct Memory Access (DMA) .................................................................. 54
9.1.1. Implementing Scatter/Gather DMA .................................................................... 55
9.1.2. Implementing Contiguous-Buffer DMA ........................................................... 57
9.1.2.1. Preallocating Contiguous DMA Buffers on Windows ............................ 59
9.2. Handling Interrupts ........................................................................................................ 62
9.2.1. Interrupt Handling — Overview ........................................................................ 62
9.2.2. WinDriver Interrupt Handling Sequence ............................................................ 64
9.2.3. Registering IRQs for Non-Plug-and-Play Hardware on Windows 7 and
Higher ............................................................................................................................ 65
9.2.4. Determining the Interrupt Types Supported by the Hardware ........................... 66
9.2.5. Determining the Interrupt Type Enabled for a PCI Card ................................... 67
9.2.6. Setting Up Kernel-Mode Interrupt Transfer Commands .................................... 67
9.2.6.1. Interrupt Mask Commands ...................................................................... 68
9.2.6.2. Sample WinDriver Transfer Commands Code ........................................ 68
9.2.7. WinDriver MSI/MSI-X Interrupt Handling ........................................................ 69
