Pro Windows Embedded Compact 7

【实例截图】

【核心代码】

Contents at a Glance
About the Author ..................................................................................................... xiii
About the Technical Reviewer ................................................................................. xiv
Acknowledgments .................................................................................................... xv
Introduction ............................................................................................................. xvi
■ ■Chapter 1: The Foundation of Device Driver Development
for Windows Embedded Compact ............................................................................... 1
■ ■Chapter 2: The Tools of the Trade .......................................................................... 21
■ ■Chapter 3: Design your Device Driver First! .......................................................... 45
■ ■Chapter 4: Mastering the Hardware Environment ................................................. 55
■ ■Chapter 5: Device Driver Registry Settings ........................................................... 69
■ ■Chapter 6: Understanding Device Driver Types ..................................................... 81
■ ■Chapter 7: The Essence of Stream Device Drivers ................................................. 91
■ ■Chapter 8: Device Driver I/O and Interrupts ........................................................ 127
■ ■Chapter 9: Device I/O Control Handling ............................................................... 145
■ ■Chapter 10: Network Driver Interface Specification
and Network Device Drivers ................................................................................... 159
■ ■Chapter 11: Debugging Device Drivers ................................................................ 191
■ ■Chapter 12: Using CTK to Develop Test Code ....................................................... 227
Index ....................................................................................................................... 255
iv
Contents
About the Author ..................................................................................................... xiii
About the Technical Reviewer ................................................................................. xiv
Acknowledgments .................................................................................................... xv
Introduction ............................................................................................................. xvi
■ ■Chapter 1: The Foundation of Device Driver Development
for Windows Embedded Compact ............................................................................... 1
In this chapter: ................................................................................................................... 1
Embedded Operating System Architectures ...................................................................... 1
Microkernel Architecture .......................................................................................................................... 2
Monolithic Architecture ............................................................................................................................ 3
Windows CE System Architecture and I/O Handling .......................................................... 5
Device Driver-Related System Components ............................................................................................. 5
Windows Embedded Compact 7 Memory Architecture ............................................................................ 6
Input/Output Handling ............................................................................................................................ 10
Windows Embedded Compact Device Driver Model ........................................................ 12
Native Windows CE Device Drivers ......................................................................................................... 12
Stream Interface Device Drivers in Windows Embedded Compact ........................................................ 13
Monolithic and Layered Device Drivers .................................................................................................. 14
Windows Embedded Compact Device Drivers in Kernel or User Mode ........................... 15
Kernel Mode Device Drivers ................................................................................................................... 15
User Mode Device Drivers ...................................................................................................................... 15
■ CONTENTS
v
Loading and Unloading Device Drivers ............................................................................ 16
Loading Stream Interface Device Drivers ............................................................................................... 16
Chapter Summary ............................................................................................................ 19
■ ■Chapter 2: The Tools of the Trade .......................................................................... 21
In this chapter: ................................................................................................................. 21
Visual Studio 2008 ........................................................................................................... 21
Visual Studio 2008 and Platform Builder IDE .......................................................................................... 22
Remote Tools .......................................................................................................................................... 25
Platform Builder ............................................................................................................... 26
Platform Builder Directory Tree .............................................................................................................. 26
Platform Builder IDE ............................................................................................................................... 28
The Build System ............................................................................................................. 30
Overview ................................................................................................................................................. 30
The Build Tools ....................................................................................................................................... 31
How to Prepare Your Development Environment ................................................................................... 34
Device Driver Development Kit ........................................................................................ 38
CEDDK Dynamic-Link Library ................................................................................................................. 39
Registry Helper Library ........................................................................................................................... 39
TRACE32-ICD ................................................................................................................... 39
Overview ................................................................................................................................................. 39
How to Prepare your Trace Tools ........................................................................................................... 41
Device Driver Wizard ....................................................................................................... 43
Overview ................................................................................................................................................. 43
Best Practice .......................................................................................................................................... 43
Chapter Summary ............................................................................................................ 44
■ CONTENTS
vi
■ ■Chapter 3: Design your Device Driver First! .......................................................... 45
In this chapter .................................................................................................................. 45
The Device Driver Location .............................................................................................. 46
BSP ......................................................................................................................................................... 47
Specific OS Design ................................................................................................................................. 47
PUBLIC Tree ............................................................................................................................................ 48
Deciding the Mode ........................................................................................................... 48
Kernel Mode ........................................................................................................................................... 48
User Mode .............................................................................................................................................. 48
The Registry ..................................................................................................................... 49
Device Driver Type ........................................................................................................... 49
Device Driver Features .................................................................................................... 49
Direct Memory Access ............................................................................................................................ 50
Interrupt Support .................................................................................................................................... 50
Power Management Support .................................................................................................................. 50
IO Control Codes .............................................................................................................. 50
Designing Physical Device Driver (PDD) .......................................................................... 51
Designing for Testing ....................................................................................................... 52
Chapter Summary ............................................................................................................ 53
■ ■Chapter 4: Mastering the Hardware Environment ................................................. 55
In this chapter: ................................................................................................................. 55
Introduction ..................................................................................................................... 55
I/O Device Registers ........................................................................................................ 56
Status Registers ..................................................................................................................................... 57
Control registers ..................................................................................................................................... 59
Data Registers ........................................................................................................................................ 60
Accessing Registers ............................................................................................................................... 60
■ CONTENTS
vii
I/O Device Interrupts ........................................................................................................ 63
Interrupt Priorities .................................................................................................................................. 63
Interrupt Vectors ..................................................................................................................................... 63
Signaling Mechanisms ........................................................................................................................... 63
I/O Device Memory .......................................................................................................... 64
Programmed I/O (PIO) ............................................................................................................................. 64
Device Dedicated Memory ...................................................................................................................... 64
Direct Memory Access – DMA ......................................................................................... 65
System DMA ........................................................................................................................................... 65
Bus Master DMA ..................................................................................................................................... 65
PCI Bus ............................................................................................................................ 66
Chapter Summary ............................................................................................................ 66
■ ■Chapter 5: Device Driver Registry Settings ........................................................... 69
In this chapter: ................................................................................................................. 69
Registry Overview ............................................................................................................ 69
Registry Types ........................................................................................................................................ 69
The Object Store ..................................................................................................................................... 70
RAM-Based Registry ............................................................................................................................... 70
Hive-Based Registry ............................................................................................................................... 70
Summary ................................................................................................................................................ 71
Device Driver File Names ................................................................................................. 71
Device File Namespace - Prefixes and Indexes ...................................................................................... 71
Device File Namespace – Mount points ................................................................................................. 71
Load Sequence ................................................................................................................ 72
Loading Sequence of a Stream Device Driver ........................................................................................ 72
Device Manager Registry Keys ........................................................................................ 74
Active registry key .................................................................................................................................. 74
■ CONTENTS
viii
Registry Entries ............................................................................................................... 74
Required ................................................................................................................................................. 75
Optional .................................................................................................................................................. 75
User Mode Driver Framework Registry Settings .................................................................................... 77
Creating a Registry Entry for a Device Driver .................................................................. 77
Creating the Registry Settings File ......................................................................................................... 77
Chapter Summary ............................................................................................................ 79
■ ■Chapter 6: Understanding Device Driver Types ..................................................... 81
In this chapter: ................................................................................................................. 81
Native Device Drivers....................................................................................................... 81
Stream Device Drivers ..................................................................................................... 82
Hybrid Device Drivers ...................................................................................................... 82
Monolithic vs. Layered Device Drivers ............................................................................. 83
Device Interface Class ..................................................................................................... 84
Device Interface GUID ............................................................................................................................. 84
Device Interface Notifications .......................................................................................... 85
Message Queue Point to Point Notification ............................................................................................ 85
Notification via WM_DEVICECHANGE ...................................................................................................... 87
Chapter Summary ............................................................................................................ 88
■ ■Chapter 7: The Essence of Stream Device Drivers ................................................. 91
In this chapter .................................................................................................................. 91
Stream Interface Device Drivers ...................................................................................... 91
Structure of Stream Interface Device Drivers ......................................................................................... 92
Kernel Mode Device Drivers .......................................................................................... 111
Access Checking .................................................................................................................................. 111
Marshalling ........................................................................................................................................... 113
■ CONTENTS
ix
Filter Device Drivers ...................................................................................................... 114
User Mode Device Drivers ............................................................................................. 119
Restrictions on User Mode Device Drivers ........................................................................................... 119
Implementing a User Mode Device Driver ............................................................................................ 120
Loading and Initializing a User Mode Device Driver ............................................................................. 121
Chapter Summary .......................................................................................................... 125
■ ■Chapter 8: Device Driver I/O and Interrupts ........................................................ 127
In this chapter ................................................................................................................ 127
Interrupt Model .............................................................................................................. 127
Interrupt Architecture ........................................................................................................................... 128
Interrupt Processing ...................................................................................................... 128
The Interrupt Service Routine - ISR ...................................................................................................... 129
The Interrupt Service Thread - IST ....................................................................................................... 137
I/O Memory Mapping ..................................................................................................... 139
Port-mapped I/O ................................................................................................................................... 140
Memory-mapped I/O ............................................................................................................................. 142
Chapter Summary .......................................................................................................... 144
■ ■Chapter 9: Device I/O Control Handling ............................................................... 145
In this chapter ................................................................................................................ 145
What Is an IOCTL ............................................................................................................ 145
Kernel IOCTLs ....................................................................................................................................... 146
Adding Device Specific IOCTLs ...................................................................................... 152
Processing Device Specific IOCTLs ................................................................................ 153
Power Management Support ................................................................................................................ 155
Chapter Summary .......................................................................................................... 157
■ CONTENTS
x
■ ■Chapter 10: Network Driver Interface Specification
and Network Device Drivers ................................................................................... 159
In this chapter ................................................................................................................ 159
Overview ........................................................................................................................ 159
NDIS ...................................................................................................................................................... 161
The Network Device Driver Layers ....................................................................................................... 161
NDIS Miniport Driver ...................................................................................................... 163
NDIS Miniport Driver Functions ............................................................................................................ 163
Physical Data Transactions .................................................................................................................. 182
NDIS Memory Management Helpers..................................................................................................... 182
NDIS Protocol Driver ...................................................................................................... 184
ProtocolSetOptions ............................................................................................................................... 184
ProtocolBindAdapterEx ......................................................................................................................... 184
ProtocolUnbindAdapterEx ..................................................................................................................... 184
ProtocolOpenAdapterCompleteEx ......................................................................................................... 185
ProtocolCloseAdapterCompleteEx ........................................................................................................ 185
ProtocolNetPnPEvent ............................................................................................................................ 185
ProtocolUninstall................................................................................................................................... 185
ProtocolReceiveNetBufferLists ............................................................................................................. 185
ProtocolSendNetBufferListsComplete .................................................................................................. 186
NDIS Intermediate Driver ............................................................................................... 186
Registry Settings ........................................................................................................... 187
Chapter Summary .......................................................................................................... 189
■ ■Chapter 11: Debugging Device Drivers ................................................................ 191
In this chapter ................................................................................................................ 191
Overview of Debugging Tools and Techniques .............................................................. 191
Debugging Techniques ......................................................................................................................... 192
Debugging Tools ................................................................................................................................... 192
■ CONTENTS
xi
Simple and Effective Debugging Techniques ................................................................ 192
Debug Messages ........................................................................................................... 193
Debug Zones ......................................................................................................................................... 194
Kernel Debugger ............................................................................................................ 200
CeDebugX ............................................................................................................................................. 202
Hardware Assisted Debugging ...................................................................................... 203
TRACE 32 .............................................................................................................................................. 204
eXDI ...................................................................................................................................................... 208
Target Control ................................................................................................................ 209
Creating Debug Extensions ................................................................................................................... 209
Remote Tools ................................................................................................................. 211
Device Side Implementation ................................................................................................................. 212
Desktop Remote Tool Plug-In Implementation ..................................................................................... 214
Postmortem Debugging and Dr. Watson ........................................................................ 220
Error Report Generator ......................................................................................................................... 221
Error Report Transfer Driver ................................................................................................................. 223
Error Report Control Panel .................................................................................................................... 223
Report Upload Client ............................................................................................................................. 224
Minidumps and Buckets ....................................................................................................................... 225
Chapter Summary .......................................................................................................... 225
■ ■Chapter 12: Using CTK to Develop Test Code ....................................................... 227
In this chapter ................................................................................................................ 227
Windows Embedded Compact Test Kit .......................................................................... 227
Overview ............................................................................................................................................... 227
User Interface ....................................................................................................................................... 228
Creating a Test Pass ............................................................................................................................. 230
Designing Test ............................................................................................................... 234
■ CONTENTS
xii
TUX Test Harness ........................................................................................................... 235
Implementing a TUX Test DLL ............................................................................................................... 235
Running the Test .................................................................................................................................. 238
Viewing and Analyzing Test results ............................................................................... 240
Performance testing ...................................................................................................... 243
Adding a Second Test Procedure ......................................................................................................... 243
Chapter Summary .......................................................................................................... 252
Index ....................................................................................................................... 255