Using This Documentation
Documentation Roadmap
Using This Documentation Online
Documentation Conventions
Section 1 Driver Writer’s Guide
Chapter 1 Driver Development Environment
1.1 Free Build and Checked Build
1.2 Debugging Environment
Chapter 2 testing Drivers
2.1 Driver Verifier
2.1.1 Capabilities Of Driver Verifier
2.1.2 Capabilities of Driver Verifier for Graphics Drivers
2.1.3 Activating and Monitoring Driver Verifier
Section 2 Plug and Play, Power Management, and Setup Design guide
Part 1 Requirements for Plug and Play and Power Management
Chapter 1 Introduction to Plug and Play and Power Management
1.1 What Is Plug and Play?
1.1.1 PnP Components
1.1.2 Levels of Support for PnP
1.2 What Is Power Management?
1.2.1 Industry Initiatives for Power Management
1.2.2 Levels of Support for Power Management
1.2.3 System-Wide Overview of Power Management
1.2.4 Power States
1.3 Device Tree
1.4 Driver Layers and Device Objects
1.4.1 Kinds of Drivers
1.4.2 Driver Layers－An Example
1.4.3 Kinds of Device Objects
1.4.4 Device Objects－An Example
Chapter 2 Required Driver Support for PnP and Power Management
2.1 Overview of Required PnP Support
2.2 PnP and Power Management DriverEntry Routine
2.3 PnP and Power Management AddDevice Routine
2.3.1 Guidelines for Writing AddDevice Routines
2.4 The DispatchPnP Routine
2.5 The DispatchPower Routine
2.6 PnP and Power Management Unload Routine
Part 2 Plug and Play
Chapter 1 Understanding PnP
1.1 PnP Driver Design Guidelines
1.2 PnP and the Device Tree
1.3 PnP Device States
1.4 Dynamically Adding a New PnP Device
1.5 HardWare Resources
1.5.1 Logical Configurations
1.6 Using GUIDs in Drivers
1.6.1 Defining and Exporting New GUIDs
1.6.2 Including GUIDs in Driver Code
Chapter 2 Rules for Handling Plug and Play IRPs
2.1 PnP IRP Requirements
2.2 Passing PnP IRPs Down the Device Stack
2.3 Postponing PnP IRP Processing Until Lower Drivers Finish
Chapter 3 Starting, Stopping, and Removing Devices
3.1 Starting a Device
3.1.1 Starting a Device in a Function Driver
3.1.2 Starting a Device in a Filter Driver
3.1.3 Starting a Device in a Bus Driver
3.1.4 Start Device Design Considerations
3.2 Stopping a Device for Resource Rebalancing
3.2.1 Understanding When Stop IRPs Are Issued
3.2.2 Handling an IRP_MN_OUERY_STOP_DEVICE Request
3.2.3 Handling an IRP_STOP_DEVICE Request
3.2.4 Handling an IRP_,NN_CANCEL_STOP_DEVICE Request
3.2.5 Holding Incoming IRPs When a Device Is Paused
3.3 Removing a Device
3.3.1 Understanding When Remove IRPs Are Issued
3.3.2 Handling an IRP_MN_QUERY_REMOVE_DEVICE Request
3.3.3 Handling an IRP_MN_QREMOVE_DEVICE Request
3.3.4 Handling an IRP_MN_CANCEL_REMOVE_DEVICE Request
3.3.5 Handling an IRP_MN_SURPRISE_REMOVAL Reqest
ChaPter 4 Using PnP Notification
4.1 PnP Notification Overview
4.2 Guidelines for Writing PnP Notification Callback Routines
4.3 Using PnP Device Interface Change Notification
4.3.1 Registering for Device Interface Change Notification
4.3.2 Handling Device Interface Change Events
4.4 Using PnP Target Device Change Notification
4.4.1 Registering for Target Device Change Notification
4.4.2 Handling a GUID_TARGET_DEVICE_QUERY_REMOVE Event
4.4.3 Handling a GUID_TARGET_DEVICE_REMOVE_COMPLETE Event
4.4.4 Handling a GUID_TARGET_DEVICE_REMOVE_CANCELLED Event
4.5 Using PnP Hardware Profile Change Notification
4.5.1 Registering for Hardware Profile Change Notification
4.5.2 Handling Hardware Profile Change Events
4.6 Using PnP Custom Notification
Chapter 5 Supporting Multifunction Devices
5.1 Supporting Multifunction PC Card Devices
5.1.1 Supporting PC Cards That Conform to the Multifunction Standard
5.1.2 Supporting PC Cards That Have Incomplete Configuration Register Addresses
5.1.3 Supporting PC Cards That Have Incomplete Configuration Registers
5.2 Supporting Multifunction PCI Devices
5.3 Supporting Multifunction Devices On Other Buses
5.4 Using the System-Supplied mf.sys
5.5 Creating Resource Maps for a Multifunction Device
Part 3 Power Management
Chapter 1 Supporting Power Management in Drivers
1.1 Kernel-Mode Power Management Components
1.1.1 ACPI BIOS
1.1.2 ACPI Driver
1.1.3 Power Manager
1.1.4 Driver Role in Power Management
1.2 Power Management Responsibilities for Drivers
1.2.1 Reporting Device Power Capabilities
1.2.2 Setting Device Object Flags for Power Management
1.2.3 Handling Power IRPs
1.2.4 Powering Up a Device
1.2.5 Powering Down a Device
1.2.6 Enabling Device Wake-up
1.3 Rules for Handling Power IRPs
1.3.1 Using PoCallDriver
1.3.2 Passing Power IRPs
1.3.3 Queuing I/O Requests While a Device Is Sleeping
1.3.4 Handling Unsupported or Unrecognized Power IRPs
Chapter 2 Managing Power for Individual Devices
2.1 Device Power States
2.1.1 Device Working State Do
2.1.2 Device Sleeping States D1, D2, and D3
2.1.3 Required Support for Device Power States
2.2 Managing Device Power Policy
2.3 Handling IRP_MN_SET_POWER for Device Power States
2.3.1 Handling Device Power-down IRPs
2.3.2 Handling Device Power-up IRPs
2.3.3 IoCompletion Routines for Device Power IRPs
2.4 Handling IRP_MN_QUERY_POWER for Device Power States
2.5 Sending IRP_MN_QUERY_POWER or IRP_MN_SET_POWER for Device Power States
2.6 Detecting an Idle Device
2.6.1 Using Power Manager Routines for Idle Detection
2.6.2 Performing Device-Specific Idle Detection
Chapter 3 Handling System Power State Requests
3.1 System Power States
3.1.1 System Working State S0
3.1.2 System Sleeping States S1, S2, S3, S4
3.1.3 System Shutdown State S5
3.1.4 System Power Actions
3.2 System Power Policy
3.3 Preventing System Power State Changes
3.4 Handling IRP_MN_QUERY_POWER for System Power States
3.4.1 Failing a System Query-Power IRP
3.4.2 Handling a System Query-Power IRP in a Device Power Policy Owner
3.4.3 Handling a System Query-Power IRP in a Bus Driver
3.4.4 Handling a System Query-Power IRP in a Filter Driver
3.5 Handling IRP_MN_SET_POWER for System Power States
3.5.1 Handling a System Set-Power IRP in a Device Power Policy Owner
3.5.2 Handling a System Set-Power IRP in a Bus Driver
3.5.3 Handling a System Set-Power IRP in a Filter Driver
Chapter 4 Supporting Devices that Have Wake-up Capabilities
4.1 Overview of Wait/Wake Operation
4.1.1 Determining Whether a Device Can Wake the System
4.1.2 Understanding the Path of Wait/Wake IRPs through a Device Tree
4.1.3 Overview of Wait/Wake IRP Completion
4.2 Steps in Handling a Wait/Wake IRP
4.2.1 Handling a Wait/Wake IRP in a Function (FDO) or Filter Driver (Filter DO)
4.2.2 Handling a Wait/Wake IRP in a Bus Driver (PDO)
4.2.3 IoCompletion Routines for Wait/Wake IRPs
4.3 Sending a Wait/Wake IRP
4.3.1 Determining When to Send a Wait/Wake IRP
4.3.2 Wait/Wake IRP Requests
4.3.3 Wait/Wake Callback Routines
4.3.4 Canceling a Wait/Wake IRP
4.4 Cancel Routines for Wait/Wake IRPs
Part 4 Setup
Chapter 1 Device InstalIation Overview
1.1 Device Installation Components
1.2 Sample PnP Device Installation
1.3 How Does Setup Select a Driver For a Device?
1.4 System Setup Phases
Chapt6r 2 Providing a Driver For a Device
2.1 Driver Files
2.2 Driver Information in the Registry
2.3 Specifying Driver Load Order
2.4 Installing Filter Drivers
2.5 Installing a Null Driver for a Device
Chapter 3 Creating an INF File
3.1 General Guidelines for INF Files
3.2 Specifying the Source and Target Locations for Device Files
3.3 Creating a Cross-Platform and/or Dual-OS INF File
3.4 Creating International INF Files
3.5 Tightening File-Open Security in a Device INF File
3.6 Accessing INF Files From an Application
3.6.1 Opening and Closing an INF File
3.6.2 Retrieving Information From an INF File
Chapter 4 Writing a Coinstaller
4.1 Coinstaller Overview
4.2 Coinstaller Interface
4.3 Coinstaller Operation
4.3.1 Handling DIF Codes
4.4 Registering a Coinstaller
4.4.1 Registering a Device-Specific Coinstaller
4.4.2 Registering a Class Coinstaller
Chapter 5 Writing a Class Installer
5.1 Class Installer Interface
5.2 Device Installation Functions Summary
5.3 Registering a Class Installer
5.4 Tightening File-Open Security in a Class Installer INF File
Chapter 6 Writing a Custom Device Installation Application
6.1 Installing a Software Utility That Accompanies a Driver
6.2 Custom Installation Application Guidelines
Chapter 7 Providing Device Property Pages
7.1 Required Support for Device Property Pages
7.2 Handling DIF_ADDPROPERTYPAGE_ADVANCED Requests
7.3 Property Page Callback Function
7.4 Handling Windows Messages for ProPerty Pages
Chapter 8 Troubleshooting Device Installation
8.1 Using SetupAPI Logging
8.1.1 Setting SetupAPI Logging Levels
8.1.2 Interpreting a Sample SetupAPI Log File
8.2 Displaying Hidden Devices in Device Manager
Chapter 9 Installing a Device Required to Boot the Machine
Section 3 Kernel-Mode Drivers Design Guide
Part 1 General Kernel Mode
Chapter 1 Windows 2000 and WDM Drivers
1.1 Overview of Widnows 2000 Components
1.2 Kinds of Drivers in Windows 2000
1.3 Windows 2000 and WDM Driver Design Goals
1.3.1 Portability
1.3.2 Configurability
1.3.3 Always Preemptible and Always Interruptible
1.3.4 Multiprocessor-Saft
1.3.5 Object-Based
1.3.6 Packet-Driven I/O with Reusable IRPs
1.3.7 Supporting Asynchronous I/O
Chapter 2 Layered I/O，IRPS，and I/O Objects
2.1 Overview of the Windows 2000 I/O Model
2.2 End-User I/O Requests and Windows 2000 File Objects
2.2.1 Points to Consider about User I/O Requests
2.3 IRPs and Driver-Specific I/O Stack Locations
2.3.1 Points to Consider about Processing IRPs
2.4 Driver Objects and Standard Driver Routines
2.4.1 Object Opacity
2.4.2 Standard Driver Object Entry Points
2.4.3 Other Standard Driver Routines
2.4.4 Points to Consider about Standard Driver Routines
2.5 Device Configurations and Layered Drivers
2.5.1 Sample Device and Driver Configuration
2.5.2 Points to Consider about adding Drivers
2.6 Device Objects and Layered Drivers
2.6.1 Device Objects for Sample Configuration
2.6.2 Points to Consider about Device Objects
Chapter 3 System-Defined Objects and Support for Drivers
3.1 System Components and Layered Kernel-Mode Drivers
3.1.1 Support Routines that Manipulate System-Defined Objects
3.1.2 Storage for System-Defined Objects
3.2 Device Objects and Device Extensions
3.2.1 Defining a Device Extension
3.2.2 Creating a Device Object and Device Extension
3.2.3 Initializing Driver-Specific Device Objects and Device Extensions
3.2.4 Setting Up Access to User Buffers
3.3 Adapter Objects and DMA
3.3.1 Map Registers
3.3.2 Getting an Adapter Object
3.3.3 Splitting Transfer Requests
3.3.4 Using System DMA
3.3.5 Using Busmaster DMA
3.3.6 Performing Scatter/Gather DMA
3.4 Controller Objects
3.4.1 Creating a Controller Object with a Controller Extension
3.4.2 Allocating the Controller Object for I/O Operations
3.5 Interrupt Objects
3.5.1 Getting a System-Assigned Interrupt Vector，DIRQL，and Processor Mask
3.5.2 Registering an ISR
3.6 DPC Objects
3.6.1 Registering and Queuing a DpcForIsr Routine
3.6.2 Registering and Queuing a CustomDpc Routine
3.7 Timer Objects with Associated DPCs
3.7.1 Registering and Enabling an IoTimer Routine
3.7.2 Registering and Queuing a CustomTimerDpc Routine
3.8 Device Queue Objects and Interlocked Queues
3.8.1 Setting up a Device Queue Object and Queuing IRPs
3.8.2 Setting up an Interlocked Queue and Queuing IRPs
3.9 Kernel Dispatcher Objects
3.9.1 Time Objects
3.9.2 Event Objects
3.9.3 Semaphore Objects
3.9.4 Mutex Objects
3.9.5 Treatment of Alerts and APCs by Threads Waiting on Dispatcher Objects
3.10 Callback Objects
3.10.1 Defining a Callback Object
3.10.2 Using a Driver-Defined Callback Object
3.10.3 Using a System-Defined Callback Object
Chapter 4 Basic Driver Structure
4.1 Standard Driver Routines
4.2 Lowest-Level Device Drivers’Staged IRP Processing
4.3 Intermediate Drivers’Staged IRP Processing
4.4 Designing and Developing a Driver
4.4.1 Naming Device Objects and Registering Device Interfaces
4.4.2 Choosing Names for Driver Routines
4.4.3 Starting Design
4.4.4 Starting Development
Chapter 5 DriverEntry and Reinitialize Routines
5.1 DriverEntry Routine Requirements
5.1.1 DriverEntry Routine Syntax and Parameters
5.1.2 Return from DriverEntry
5.2 DriverEntry Routine Functionality
5.2.1 Every DriverEntry Routine’s Responsibilities
5.2.2 DriverEntry’s Optional Responsibilities
5.3 Reinitialize Routine Requirements and Functionality
Chapter 6 Dispatch Routines
6.1 Dispatch Routine Requirements
6.1.1 Commonly Implemented Dispatch Routines
6.1.2 Conditionally Implemented Dispatch Routines
6.2 Basic Dispatch Routine Functionality
6.2.1 When to Check the I/O Stack Location
6.2.2 How to Complete an IRP in a Dispatch Routine
6.2.3 When to Complete an IRP in the Dispatch Routine
6.2.4 How to Pass IRPs with Valid Parameters on from a Dispatch Routine
6.2.5 Allocating IRPs for Lower-Level Drivers
6.2.6 Handling Asynchronous Transfer Requests
6.3 Designing Dispatch Routines
6.3.1 DispatchCreate and DispatchClose Functionality
6.3.2 DispatchCleanup Functionality
6.3.3 DispatchRead or DispatchWrite Functionality
6.3.4 Dispatch(Internal)DeviceControl Functionality
Chapter 7 StartIo and Queue Management Routines
7.1 Queuing IRPs
7.2 StartIo Routine Requirements
7.2.1 StartIo Routines in Device Drivers
7.2.2 StartIo Routine Functionality
7.2.3 Programming the Device for I/O Operations
7.2.4 StartIo Routines in Higher-Level Drivers
7.2.5 Points to Consider in Implementing StartIo
7.3 Requirements for Using Interlocked Queues or Device Queues
7.3.1 Storage Requirements for Driver-Managed Queues
7.3.2 Setting Up Driver-Managed Queues
7.3.3 Queuing IRPs in Driver-Managed Queues
7.3.4 Managing Interiocked Queues with a Driver-Created Thread
7.3.5 Managing Supplemental Device Queues
Chapter 8 Unterrupt Service Routine
8.1 ISR Requirements
8.1.1 ISR Performance
8.1.2 Additional Required Driver Routines
8.1.3 Setting Up an ISR
8.2 Basic ISR Functionality
8.3 ISR Functionality for Overlapped I/O Operations
Chapter 9 DpcForIsr Routine and CustomDpc Routines
9.1 DpcForIsr and CustomDpc Routine Requirements
9.1.1 DpcForIsr versus CustonDpc Routines
9.1.2 Basic DpcForIsr Requirements
9.1.3 Basic CustomDpc Routine Requirements
9.1.4 Additional Required Driver Routines
9.1.5 Setting Up DpcForIsr and CustomDpc Routines
9.2 DpcforIsr and CustomDpc Functionality
9.2.1 Using Buffered I/O and Satisfying Device Control IRPs
9.2.2 Using Direct I/O
9.2.3 Points to Consider in Implementing a DpcForIsr or CustomDpc Routine
Chapter 10 SynchCritSection Routines
10.1 SynchCritSection Routine Requirements
10.1.1 Using a SynchCritSection Routine
10.1.2 Running a SynchCritSection Routine
10.1.3 SynchCritSection Routine Performance Requirements
10.2 SynchCritSection Routine Functionality
10.2.1 Programming the Device for and I/O Operations
10.2.2 Maintaining State About Interrupt-Driven I/O Operations
Chapter 11 AdapterControl and Controllercontrol Routines
11.1 Driver Control Routines
11.1.1 Driver Control Routine Syntax and Parameters
11.1.2 Returns from DriverControl Routines
11.1.3 Designing Drivers with Drivercontrol Routines
11.1.4 Storage Requirements
11.1.5 Setting Up AdapterControl and ControllerControl Routines
11.2 AdapterControl Routine Requirements
11.3 ControllerControl Routine Requirements
Chapter 12 Cancel Routines
12.1 Cancel Routine Requirements
12.2 Handling cancelable IRPs
12.2.1 Handling Cancelable IRPs in Driver Routines That Pass IRPs On
12.2.2 Handling Cancelable IRPs In Driver Routines That Process Requests
12.2.3 Using the System Cancel Spin Lock
12.2.4 Using a Driver-Supplied Spin Lock with Cancel Routines
12.3 Cancel Routine Functionality
12.3.1 Cancel Routines in Drivers with StartIo Routines
12.3.2 Cancel Routines in Drivers without StartIo Routines
12.4 Points to Consider In Handling Cancelable IRPs
Chapter 13 IoCompletion Routines
13.1 Using IoComPletion Routines
13.1.1 Setting UP an IoCompletion Routine
13.1.2 Calling IoSetCompletionRoutine
13.1.3 Allocating IRPs for Lower Drivers
13.2 IoComPletion Routine Required Functionality
Chapter 14 IoTimer and CustomTimerDpc Routines
14.1 Timer Routine Requirements
14.2 IoTimer Routine Functionality
14.2.1 Setting Up an IoTimer Routine
14.2.2 Setting Up Context for an IoTimer Routine
14.2.3 Using an IoTimer Routine
14.3 CustomTimerDpc Routine Functionality
14.3.1 Setting Up a CustomTimerDpc Routine
14.3.2 Setting Up Context for a CustomTimerDpc Routine
14.3.3 Using a CustomTimerDpc Routine
Chapter 15 Unload Routine
15.1 Unload Routine Requirements
15.2 Unload Routine Environment
15.3 Unload Routine Functionality
15.3.1 PnP Drivers’Unload Functionality
15.3.2 Non-Pnp Drivers’Unload Functionality
Chapter 16 Common Driver Design Issues
16.1 Managing Hardware Priorities
16.2 Using Spin Locks
16.2.1 Providing Storage for Spin Locks and Protected Data
16.2.2 Initializing Spin Locks
16.2.3 Calling Support Routines That Use Spin Locks
16.2.4 Releasing Spin Locks Promptly
16.2.5 Preventing Errors or Deadlocks While Using Spin Locks
16.3 Polling a Device
16.3.1 Driver Threads
16.4 Managing Memory Usage
16.4.1 Using System Memory
16.4.2 Using the Kernel Stack
16.4.3 Using Lookaside Lists
16.4.4 Read-Only Memory Protection
16.5 Maintaining Cache Coherency for DMA and PIO
16.5.1 Flushing Cached Data During DMA Operations
16.5.2 Flushing Cached Data During PIO Operations
16.6 Error Logging and NTSTATUS Values
16.6.1 Calling IoAllocateErrorLogEntry
16.6.2 Filling in an Error Log Packet
16.6.3 Setting NTSTATUS Values in Error Log Packets
16.6.4 Calling IoWriteErrorLogEntry
16.6.5 Defining New IO_ERR_XXX
16.6.6 Defining Private NTSTATUS Constants
16.7 Handling Removable Media
16.7.1 Responding to Check-Verify Requests from the File System
16.7.2 Notifying the File System of Possible Media Changes
16.7.3 Checking Flags in the Device Object
16.7.4 Setting up IRPs in Intermediate Drivers
16.8 Making a Device Available to Applications and Drivers
16.8.1 Registering a Device Interface
16.8.2 Enabling and Disabling a Device Inteiface
16.8.3 Using a Device Interface
16.9 Pageable Code and Data
16.9.1 Making Driver Code Pageable
16.9.2 Locking Pageable Code or Data
16.9.3 Paging an Entire Driver
16.10 Common Driver Reliability Issues
16.10.1 Errors in Buffered I/O
16.10.2 Errors in Referencing User-Space Addresses
16.10.3 Errors in Direct I/O
16.10.4 Error in Caller Input and Device State
16.10.5 Errors in Dispatch Routines
16.10.6 Errors in a Multiprocessor Environment
16.10.7 Errors in Handling IRPs
Section 4 Graphics Drivers Design Guide
Part 1 Graphics Drivers
Chapter 1 Graphics System Overview
1.1 Document Conventions
Chapter 2 GDI Support for Graphics Drivers
2.1 GDI from the Driver’s Perspective
2.1.1 GDI as an Application Graphics Language
2.1.2 GDI as a Rendering Engine
2.2 GDI/Driver Division of Labor
2.2.1 GDI Communication with the Driver
2.2.2 PDEV Negotiation
2.2.3 Surface Negotiation
2.3 GDI Support Services
2.3.1 GDI Support for Surfaces
2.3.2 GDI Support for Palettes
2.3.3 GDI Services for Paths
2.3.4 GDI Drawing Services, Other
2.3.5 GDI Font and Text Services
2.3.6 GDI Support Services, Other
2.4 Floating-point Support
2.5 Data Types
Chapter 3 Supporting the DDI
3.1 Graphics Driver Function Support
3.1.1 Required Graphics Driver Functions
3.1.2 Conditionally Required Graphics Driver Functions
3.1.3 Optional Graphics Driver Functions
3.2 Supporting Initialization and Termination Functions
3.2.1 Driver Initialization and Cleanup
3.2.2 PDEV Initialization and Cleanup
3.2.3 Enabling and Disabling the Surface
3.3 Creating Device-Dependent Bitmaps
3.4 Supporting Graphics Output
3.4.1 Drawing Lines and Curves
3.4.2 Drawing and Filling Paths
3.4.3 Copying Bitmaps
3.4.4 Halftoning
3.4.5 Image Color Management
3.5 Supporting DDI Color and Pattern Functions
3.5.1 Managing Palettes
3.5.2 Realizing Brushes
3.6 Supporting DDI Font and Text Functions
3.6.1 Managing and Optimizing Fonts
3.6.2 Drawing Text
Part 2 Display and Video Miniport Drivers
Chapter 1 Introduction to Display
1.1 Display Architecture
1.1.1 Display Driver Responsibilities
1.1.2 Video Miniport Responsibilities
1.2 Types of Graphics Adapters
1.2.1 Frame Buffers
1.2.2 Accelerators
1.2.3 Coprocessors
1.2.4 VGA
1.3 General Design and Implementation Strategies
1.4 Accessing the Graphics Adapter
1.4.1 Communicating IOCTLs to the Video Miniport Driver
1.4.2 Accessing the Frame Buffer and Hardware Registers
1.5 Creating Graphics INF Files
1.5.1 INF GeneralConfigData Section
1.5.2 Display INF File Sections
1.5.3 Monitor INF File Sections
1.6 Compatibility Testing Requirements for Display and Video Miniport Drivers
1.6.1 INF and Installation Requirements
1.6.2 Video Miniport Driver Requirements
1.6.3 Display driver Requirements
1.6.4 Control Panel Requirements
Chapter 2 Display Drivers
2.1 Display Driver DDI Functions
2.1.1 Required Display Driver Functions
2.1.2 Conditionally Required Display driver Functions
2.1.3 Optional Display Driver Functions
2.2 Display Driver Initialization
2.3 Desktop Management
2.3.1 Switching Desktops: Responding to DrvAssertMode
2.3.2 Returning Display Modes: DrvGetModes
2.3.3 Supporting Multiple PDEVs
2.4 Pointer Control
2.4.1 Pointer Drawing
2.4.2 Controlling the Pointer: DrvSetPointerShape
2.4.3 Moving the Pointer: DrvMovePointer
2.5 Managing Display Palettes
2.6 Bitmaps in Display Drivers
2.7 Asynchronous Rendering
2.8 Transparency in Display Drivers
2.9 Special Effects in Display Drivers
2.10 Color Management for Displays
2.10.1 Monitor Profiles
2.11 DirectDraw and GDI
2.12 Tracking Window Changes
2.13 Supporting the DitherOnRealize Flag
2.14 Supporting Banked Frame Buffers
2.15 Unloading Video Hardware
2.16 Multiple-Monitor Support in the Display Driver
2.17 Mirror Drivers
2.17.1 Mirror Driver INF File
2.17.2 Mirror Driver Installation
2.18 Display Driver Testing Tools
2.18.1 NewDisp: Dynamic Reload of a Display Driver
2.18.2 Dynamic Change of Permitted Driver Accelerations
Chapter 3 DirectDraw DDI
3.1 DirectDraw Driver Header Files, Sample Code, and References
3.2 DirectDraw Architectural Overview
3.2.1 About DirectDraw
3.2.2 DirectDraw Drivers
3.2.3 Hardware Emulation Layer
3.3 DirecMw Driver FundaInntals
3.3.1 DirectDraw Surfaces
3.3.2 Display Memory
3.3.3 Memory Configuration Examples
3.3.4 Flipping
3.3.5 Blitting
3.3.6 Drivers That Assume State Information
3.3.7 Turning On a Display Card and Changing Modes on Windows 95/98
3.4 DirectDraw Driver Initialization
3.5 Video Port Extensions to DirectX
3.5.1 Video Port Extensions Background
3.5.2 DirectX VPE Initialization
3.5.3 DirectDraw Interfaces for Kernel-Mode Video Transport Support
3.6 Color Control Initialization
3.7 AGP Support
3.7.1 Flagging Support for Nonlocal Display Memory
3.7.2 Specifying Nonlocal Display Memory Heaps
3.7.3 Notification of Actual Heap Base Addresses
3.7.4 Callback Handling of Nonlocal Display Memory Surfaces
3.7.5 Reordering Textures in Nonlocal Display Memory
3.7.6 Handling DMA-style AGP
3.8 Kernel-Mode Video Transport
3.8.1 VPE and Kernel-Mode Video Transport Architecture
3.8.2 Using the Kernel-Mode Video Transport
3.8.3 DxApi Miniport Functions for Windows 2000
3.9 Extended Surface Alignment
3.9.1 Review of the Older Alignment Method
3.9.2 Using Extended Surface Alignment
3.10 Extended Surface Capabilities
3.10.1 New Surface Capabilities
3.10.2 Exposing the Extended Surface Capabilities
3.10.3 Extended Heap Restrictions
3.10.4 Extended Surface Description Structure
3.11 Compressed Texture Surfaces
3.11.1 Enumerating DXT Formats
3.11.2 Creating the Compressed Texture Surface
3.11.3 Using Compressed Texture Surfaces
3.12 Motion Compensation
3.13 Return Values for DirectDraw and Direct3D
Chapter 4 Direct3D DDI
4.1 Direct3D DDI Header Files, Sample Code, and References
4.2 Cross-Platform Direct3D Driver Development
4.3 Direct3D Driver Callbacks and Functions
4.3.1 Required Direct3D Driver Callbacks and Functions
4.3.2 Operation Code Handling
4.3.3 Returm Codes for Direct3D Driver Callbacks
4.4 Direct3D Driver Initialization
4.5 Direct3D Context Management
4.5.1 Creating a Context
4.5.2 Deleting a Context
4.5.3 Maintaining State Within a Context
4.5.4 Overview of Direct3D Surface Handles
4.5.5 More on Handles and Creating Driver-Side Surface Structures via D3dCreateSurfaceEx
4.5.6 Why Can’t a Driver-Side Structure Simply Be a Pointer to the Surface?
4.5.7 D3dCreateSurfaceEx and Backing Surfaces
4.5.8 Other Points to Consider in D3dCreateSurfaceEx
4.6 Direct3D Texture Management
4.6.1 Multitexturing
4.6.2 Paletted Textures
4.6.3 Texture blitting
4.6.4 Driver-Managed Textures
4.7 Primitive Drawing and State Changes
4.7.1 Command and Vertex Buffers
4.7.2 Direct3D Command Buffers
4.7.3 Direct3D Vertex Buffers
4.7.4 Accelerated State Management
4.8 Flexible Vertex Format（FVF）
4.8.1 Determining the Vertex Buffer Data Format
4.9 Advanced Direct3D Driver Topics
4.9.1 Optimized textures
4.9.2 Stencil Planes
4.9.3 Guard Band Clipping
4.9.4 Extents Adjustment
4.9.5 W-Buffering
4.9.6 Bump Mapping
4.9.7 Hardware Transform and Lighting
4.10 DirectX 7.0 Release Notes
4.10.1 FVF Update
4.10.2 Rasterizer Update
Chapter 5 Mini Client Driver
5.1 MCD Header Files, Sample Code, and References
5.2 MCD Architecture
5.3 The MCD Interface
5.3.1 Required MCD Functions
5.3.2 Conditionally Required MCD Functions
5.3.3 Optional MCD Functions
5.4 MCD Initialization
5.4.1 Hdev Handle
5.4.2 Pixel Formats
5.5 Rendering Contexts
5.5.1 Context Creation
5.5.2 Context Binding
5.5.3 Context Deletion
5.5.4 State
5.5.5 Viewports
5.6 Memory Management
5.6.1 DMA Support
5.7 Framebuffer Management
5.7.1 allocating Draw Buffers
5.7.2 Querying Draw Buffers
5.7.3 Swapping Draw Buffers
5.7.4 Window Tracking in MCD
5.8 Drawing Operations
5.8.1 Drawing OpenGL Primitives
5.8.2 Drawing Spans
5.8.3 Clearing Buffers
5.8.4 Synchronization
5.9 Texture Mapping
5.9.1 Texture Environment State
5.9.2 Texture State
5.10 Pixel Operations
5.10.1 Pixel State
5.11 Layer Planes
5.11.1 Describing the Layer Planes
5.11.2 Swapping Layer Planes
5.11.3 Managing the Layer Palette
Chapter 6 Video Miniport Drivers
6.1 Video Miniport Header Files, Sample Code, and References
6.2 Video Miniport Driver Within the Graphics Architecture
6.2.1 Platform-Specific Details for Video Miniport
6.3 Video Miniport Driver Interface
6.3.1 Required Video Miniport Driver Functions
6.3.2 Conditionally Required Video Miniport Driver Functions
6.3.3 Optional Video Miniport Driver Functions
6.4 Video Miniport Initialization
6.4.1 Starting the Device of the Video Miniport
6.4.2 Claiming Legacy Resources
6.4.3 Initializing the Video Miniport for Communication with the Display Driver
6.5 Video Miniport’s Device Extension
6.6 Registry Callbacks in the Video Miniport
6.7 Processing Video Requests
6.7.1 System-Defined IOCTL_VIDEO_XXX Requests
6.7.2 Privately Defined Display-Miniport IOCTL_VIDEO_XXX Requests
6.7.3 Handling Unsupported IOCTL_VIDEO_XXX Requests
6.8 Supporting PnP and Power Management in a Video Miniport
6.9 Using AGP in the Video Miniport
6.9.1 Accessing System Memory through AGP
6.9.2 Releasing Memory from AGP Use
6.10 Child Devices of the Graphics Adapter
6.10.1 Detecting Child Devices
6.10.2 Communicating with the Driver of a Child Device
6.11 Interupts in the Video Miniport
6.11.1 When to Implement a Hw VidSynchronizeExecutionCallback Routine
6.12 Timers in the Video Miniport
6.13 Resetting the Adapter in the Video Miniport
6.14 Mirror driver Support in the Miniport
6.15 TV Connector and Copy Protection Support in the Video Miniport
6.15.1 Querying TV Connector and Copy Protection Hardware
6.15.2 Setting TV Connector and Copy Protection Hardware
6.16 VGA-Compatible Miniport’s SvgaHwIoPortXxx
6.16.1 Windowed VDMs in x86-Based Machines
6.16.2 Full-Screen VDMs in x86-based Machines
6.16.3 VGA-Compatible Miniport’s HwFindAdapter
6.16.4 Validating Instructions in SvgaHwIoPortXxx
6.16.5 VGA-Compatible Miniport’s HwVidStartIO
6.17 Converting a Windows NT 4.0 Miniport Driver to Windows 2000
Part 3 Printer Drivers and Spooler Components
Chapter 1 Introduction to Printing
Chapter 2 Print Spooler Atchitecture
2.1 Spooler Components
2.1.1 Introduction to Spooler Components
2.1.2 Print Providers
Chapter 3 Printer Driver Architecture
3.1 Printer Driver Components
3.1.1 Printer Graphics DLL
3.1.2 Printer Interface DLL
3.1.3 Printer Data Files
Chapter 4 Microsoft Universal Printer Driver
4.1 Introduction to the Universal Printer Driver
4.1.1 Unidrv Capabilities
4.1.2 Unidrv Components
4.1.3 Unidrv Minidrivers
4.1.4 Unidrv User Interface
4.1.5 Unidrv Renderer
4.1.6 Sample GPD Files
4.1.7 Microsoft Minidriver Development Tool
4.2 Introduchon to GPD Files
4.2.1 GPD File Entries
4.2.2 Master Units
4.2.3 Using Multiple GPD Files in a Minidriver
4.2.4 Using Resource DLLs in a Minidriver
4.3 Printer Attributes
4.3.1 Printer Attribute Format
4.3.2 Attribute Types
4.3.3 General Attributes
4.4 Printer Commands
4.4.1 Command Entry Format
4.4.2 Command Names
4.4.3 Command Attributes
4.4.4 Command String Format
4.4.5 Command Execution Order
4.5 Printer Features
4.5.1 Standard Features
4.5.2 Customized Features
4.5.3 Feature Entry Format
4.5.4 Feature Attributes
4.5.5 Feature Conflict Priority
4.6 Printer Options
4.6.1 Standard Options
4.6.2 Customized Options
4.6.3 Option Entry Format
4.6.4 Option Attributes
4.6.5 Option Constraints
4.7 Printer Font Descriptions
4.7.1 Hardware-Resident Fonts
4.7.2 Font Cartridges
4.7.3 Font Substitution
4.8 Conditional Statements
4.9 Compressing Raster Data
4.9.1 Using Unidrv-Supported Compression
4.9.2 Using Customized Compression
4.10 Filtering Raster Data
4.11 Handling color Formats
4.12 Handling with Unidrv
4.12.1 GDI-Supplied Halftoning
4.12.2 Minidriver-Supplied Halftoning
4.12.3 Device-Supplied Halftoning
4.13 Controlling Image Quality
4.14 Handling Installable Features and Options
4.15 Specifying Feature and Option Display Order
4.16 Describing Printer Memory Configurations
4.17 Specifying Paper Sizes
4.17.1 Supporting Standard Paper Sizes
4.17.2 Supporting Vendor-Defined Paper Sizes
4.17.3 Supporting User-Defined Paper Sizes
4.18 Referencing Locales
4.19 Installing a Unidrv Minidriver
Chapter 5 Microsoft PostScript Printer Driver
5.1 Pscript Capabilities
5.2 Pscript Components
5.3 Pscript Minidrivers
5.3.1 Converting AFM Files to NTF Files
5.3.2 Installing a Pscript Minidriver
5.4 Pscript User Interface
5.5 Pscript Renderer
Chapter 6 Microsoft Plotter Driver
6.1 Plotter Driver Capabilities
6.2 Plotter Driver Components
6.3 Sample Plotter Driver Files
6.4 Plotter Driver Minidrivers
6.4.1 PCD Source File Format
6.5 Plotter Driver User Interface
6.6 Plotter Driver Renderer
Chapter 7 Customizing Microsoft’s Printer Drivers
7.1 User Interface Plug-Ins
7.1.1 Introduction to User Interface Plug-Ins
7.1.2 Sample UI Plug-In
7.1.3 COM Interfaces for UI Plug-Ins
7.1.4 Providing DEVMODE Structure Additions
7.1.5 Accessing Driver Settings from UI Plug-Ins
7.1.6 Modifying a Driver-Supplied Property Sheet Page
7.1.7 Adding New Property Sheet Pages
7.1.8 Customizing Other Printer Interface Operations
7.2 Rendering Plug-Ins
7.2.1 Introduction to Rendering Plug-Ins
7.2.2 Sample Rendering Plug-In
7.2.3 COM Interfaces for Rendering Plug-Ins
7.2.4 Customized DDI Functions
7.2.5 Customized PDEV Structures
7.2.6 Accessing Driver Settings from Rendering Plug-Ins
7.2.7 Pscript-Specific Customized Rendering
7.2.8 Unidrv-Specific Customized Rendering
7.3 Implementing Printer Driver COM Interfaces
7.3.1 Interface Identifiers for Printer Drivers
7.3.2 Creating the Plug-In
7.3.3 Accessing Plug-In Interfaces from Printer Drivers
7.3.4 Accessing Printer Driver Interfaces from Plug-Ins
7.4 Installing Customized Driver Components
7.4.1 Customized Font Installers for Unidrv
Chapter 8 Customizing Print Spooler Components
8.1 Writipg a Print Processor
8.1.1 Introduction to Print Processors
8.1.2 Sample Print Processor
8.1.3 Functions Defined by Print Processors
8.1.4 Processing a Print Job
8.1.5 Installing a Print Processor
8.2 Writing a Print Monitor
8.2.1 Language Monitors
8.2.2 Port Monitors
8.2.3 Language and Port Monitor Interaction
8.2.4 Functions Defined by Print Monitors
8.2.5 Initializing a Print Monitor
8.2.6 Opening and Closing a Port
8.2.7 Printing a Print Job
8.2.8 Managing a Port
8.2.9 Converting Print Monitors for Use with Clustered Print Servers
8.2.10 Installing a Print Monitor
8.3 Writing a Network Print Provider
8.3.1 Overview of Partial Print Providers
8.3.2 Supporting Printer Change Notifications
8.3.3 Installing a Network Print Provider
Chapter 9 Internet Printing
9.1 Printing to URLs from Applications
9.2 Viewing Print Web Pages
9.3 Customizing Print Web Pages
9.3.1 ASP Files for Print Web Pages
9.3.2 Customizing the Printer Details Web Page
9.3.3 Installing Customized Print Web Pages
9.4 Installing Print Drivers from a Web Page
Chapter 10 Installing and Configuring Printer Drivers
10.1 Plug and Play for Printers
10.2 Printer INF Files
10.2.1 Printer DIRIDs
10.2.2 Printer INF File Entries
10.2.3 Printer INF File Data Sections
10.2.4 Printer INF File Install Sections
10.2.5 Printer INF File CopyFiles Sections
10.2.6 Sample Printer INF Files
10.3 Directory Services for Printers
10.3.1 Print Spooler Support for Printer Directory Services
10.3.2 Printer Driver Support for Printer Directory Services
10.4 Supporting Point and Print
10.4.1 Introduction to Point and Print
10.4.2 Supporting Point and Print During Printer Installations
10.4.3 Supporting Point and Print During Printer Connections
Chapter 11 CPSUI
11.1 Introduction to CPSUI
11.2 Sample CPSUI Application
11.3 CPSUI-Supplied Functions
11.4 Application-Supplied Callback Functions
11.4.1 Page Creation Callbacks
11.4.2 Page Event Callbacks
11.5 Creating Property Sheet Pages
11.5.1 Property Sheet Options
11.5.2 CPSUI-Supported Window Controls
11.5.3 CPSUI-Supplied Pages and Templates
11.5.4 Methods for Specifying Pages
11.5.5 Using CPSUI with Printer Drivers
Chapter 12 Color Management for Printers
12.1 Enabling Color Management
12.2 Controlling Color Management
12.2.1 System Control
12.2.2 Driver Control and Device Control
12.2.3 Supporting CMYK Color Space
12.2.4 Color Management of JPEG and PNG Images
12.3 Locating ICC Profiles
12.4 Installing ICC Profiles
Section 5 Network Drivers Design Guide
Part 1 Network Drivers
Chapter 1 Roadmap to the Network Drivers Design Guide
Chapter 2 Network Architecture for Kernel-Mode Drivers
2.1 Windows 2000 Network Architecture and the OSI Model
2.2 NDIS Drivers
2.2.1 NDIS Miniport Drivers
2.2.2 NDIS Intermediate Drivers
2.2.3 NDIS Protocol Drivers
2.3 TDI Drivers
2.4 Network Driver Environments
2.4.1 Connectionless Environment for Network Drivers
2.4.2 Connection-Oriented Environment for Network Drivers
2.4.3 Environment for WAN Network Drivers
Chapter 3 Network Driver Programming Considerations
3.1 Portability
3.2 Multiprocessor Support
3.3 IRQLs
3.4 Synchronization and Notification
3.5 Packet Structure
3.6 Using Shared Memory
3.7 Asynchronous I/O and Completion Functions
Part 2 Miniport NIC Drivers
Chapter 1 NDIS NIC Miniport Drivers
1.1 Types of NIC Miniports
1.2 Network Interface Card support
1.3 Important Features of Miniport Driver Code
1.3.1 MiniportXxx Functions
1.3.2 Linking to the NDIS Library
1.3.3 Miniport Adapter Context
1.3.4 VC Context
1.3.5 Network OIDs
1.4 Sample Drivers
Chapter 2 Overview of NIC Miniport Operations and Functions
2.1 NIC Miniport Operations
2.1.1 Initializing the NDIS Library and Registering the Miniport Driver
2.1.2 Resistering Network Interface Cards
2.1.3 Responding to Queries and Sets of Miniport Information
2.1.4 Creation，Activating，Deactivating，and Deleting Virtual Connections
2.1.5 Sending Data
2.1.6 Indicating and Transferring Received Data
2.1.7 Indicating Status
2.1.8 Resetting a Network Interface Card
2.1.9 Halting a Miniport NIC Driver
2.2 Miniport Upper-Edge Functions
2.2.1 Upper-Edge Functions of Connectionless Miniports
2.2.2 Upper-Edge Functions of Connection-Oriented Miniports
2.3 NDIS Functions Called by Miniports
2.3.1 NDIS-Supplied Initialization and Registration Functions
2.3.2 NDIS-Supplied Hardware Configuration Functions
2.3.3 NDIS-Supplied I/O Port Functions
2.3.4 NDIS-Supplied DMA-Related Functions
2.3.5 NDIS-Supplied Interrupt Handling Functions
2.3.6 NDIS-Supplied Synchronization Functions
2.3.7 NDIS-Supplied Status Functions
2.3.8 NDIS-Supplied Send and Receive Functions for Connectionless Miniports
2.3.9 NDIS-Supplied Send and Receive Functions for Connection-Oriented Miniports
2.3.10 NDIS-Supplied Out-of-Band Data Macros
2.3.11 NDIS-Supplied Packet and Buffer Handling Functions
2.3.12 NDIS-Supplied Support Functions
2.3.13 NDIS-Supplied Media-Specific Macros
Chapter 3 NIC Miniport DriverEntry and Initialization
3.1 NDIS Miniport DriverEntry Function
3.1.1 Initializing the Wrapper
3.1.2 Registering the Miniport
3.2 NDIS Miniport Initialization
3.2.1 Registering a NIC
3.2.2 Claiming Resources
3.2.3 Registering An Interrupt
3.2.4 Registering a Shutdown Function
3.2.5 Initializing Polling Timers
3.2.6 Synchronization During Initialization
3.2.7 Handling Errors During Initialization
3.3 Querying Miniport Information
3.4 Minimizing Miniport Initialization Time
Chapter 4 Transferring Data
4.1 Handling an Interrupt
4.2 DPC Handler
4.3 Packet Out-Of-Band Data
4.3.1 OOB Data on a Send
4.3.2 OOB Data on a Receive
4.4 Sending Packets
4.4.1 Multipacket Sends from Connectionless Miniports
4.4.2 Single-Packet Sends from Connectionless Miniports
4.4.3 Multipacket Sends from Connection-Oriented Miniports
4.4.4 Synchronizing Memory Before Sending Data
4.4.5 Steps in Sending
4.5 Deserialized Miniports
4.5.1 NDIS Requirements for Deserialized Miniports
4.5.2 Driver-Internal Requirements for Deserialized Miniports
4.6 Receiving Data
4.6.1 Multipacket Receives from Connectionless and Connection-Oriented Miniports
4.6.2 Single-Packet Receives from Connectionless Miniports
4.6.3 Cache Considerations for Receiving Data
4.6.4 Steps in Receiving Data
4.7 Keeping Statistics
4.8 802.1P Packet Priority
4.8.1 Query for 802.1p Priority Support
4.8.2 Packet Support for 802.1p Priority
4.8.3 Specify Packet Size for Sends and Receives
4.8.4 Disable 802.1p Priority Support by Default
Chapter 5 Obtaining and Setting Miniport Information and NDIS Support for WMI
5.1 NDIS Management Information and OIDs
5.2 Querying Miniport Information
5.2.1 Querying a Connectionless Miniport
5.2.2 Querying a Connection-Oriented Miniport
5.3 Setting Miniport Information
5.3.1 Setting Information for a Connectionless Miniport
5.3.2 Setting Information for a Connection-Oriented Mipiport
5.3.3 Occasions for Setting Miniport Information
5.4 Reporting Hardware Status
5.5 NDIS Support for WMI
5.5.1 Registration and Deregistration of NDIS Miniports with WMI
5.5.2 Mapping of GUIDs to OIDs and Miniport Status
5.5.3 Support for Named VCs
5.5.4 NDIS-Supported WMI Operations
5.5.5 Standard Miniport OIDs Registered with WMI
5.5.6 Standard Miniport Status Registered with WMI
5.5.7 Customized OIDs and Status Indications
Chapter 6 Power Management for Miniports
6.1 Required and Optional OIDs for Power Management
6.2 Network Device Power States
6.3 Network Wake-Up Events
6.3.1 Link-Change Wake-Up
6.3.2 Network Wake-Up Frames
6.3.3 Magic-Packet Wake-Up
6.3.4 Enabling Wake-Up Events
6.3.5 Handling a Wake-Up Event
6.4 Handling an OID_PNP_QUERY_POWER
6.5 Handling an OID_PNP_SET_POWER
6.5.1 Transitioning to a Sleeping State
6.5.2 Transitioning to a Working State
6.6 Power-Management for Legacy Miniports
Chapter 7 Reset，Halt，and Shutdown
7.1 Hardware Reset
7.2 Halt Handler
7.3 Shutdown Handler
Chapter 8 WAN Miniport NIC Drivers
8.1 RAS Architecture
8.2 NDISWAN Overview
8.3 Network Cards, Bindings, and Connections
8.4 Implementing WAN Miniport Drivers
8.4.1 Differences Between Standard WAN and LAN Miniport Drivers
8.4.2 Additional Features of CoNDIS WAN Miniport Drivers
8.4.3 WAN Miniport Driver Services
8.4.4 WAN Miniport Driver Indications
8.5 WAN Packet Framing
8.5.1 Asynchronous Framing
8.5.2 X.25 Framing
8.5.3 ISDN and Switched 56K Framing
8.6 Extensions to Support Teleptionic Services Over Standard NDIS
8.6.1 NDISTAPI Overview
8.6.2 Line Devices, Addresses, and Calls
8.6.3 Set and Query Requests
8.6.4 Maintaining State Information
8.6.5 Setting Up Handles
8.6.6 TAPI Registration
8.6.7 TAPI Initialization
8.6.8 Line Open
8.6.9 Accepting an Incoming Call
8.6.10 Making a TAPI Call
8.6.11 Unsolicited Event Handling
8.6.12 Line-Up Indication
8.6.13 Call Line Shutdown
8.6.14 NDISTAPI Interface
8.7 Using CoNDIS Extensions that Support Telephonic Services
8.7.1 NDPROXY Overview
8.7.2 CoNDIS TAPI Registration
8.7.3 CoNDIS TAPI Initialization
8.7.4 Making Outgoing Calls
8.7.5 Accepting Incoming Calls
8.7.6 CoNDIS TAPI Shutdown
8.7.7 Call Manager Requirements for Voice Streaming
8.7.8 Non-WAN-Specific Extensions to Support Telephonic Services Over Connection-Oriented NDIS
Chapter 9 Task Offload
9.1 Querying Task-Offload Capabilities
9.1.1 Reporting a INC’s Checksum Capabilities
9.1.2 Reporting a INC’s IP Security Capabilities
9.1.3 Reporting a INC’s TCP-Packet-Segmentation Capabilities
9.2 Enabling Task-Offload Capabilities
9.3 Disabling Task-Offload Capabilities
9.4 Accessing Per-Packet Information
9.5 Offloading TCP/IP Checksum Tasks
9.6 Offloading IP Security Tasks
9.7 Offloading the Segmentation of Large TCP Packets
9.8 Combinations of Offloads
9.9 Using Registry Values To Enable and Disable Task Offloading
Chapter 10 Load Balancing and Fail Over
10.1 About LBFO
10.2 Specifying Support of LBFO
10.3 Implementing LBFO in a Miniport Driver
10.3.1 Initializing a Bundle of Miniports
10.3.2 Balancing a Miniport Driver’s Workload
10.3.3 Promoting a Secondary Miniport After the Primary Miniport Fails
Chapter 11 Fast Forwarding Path
11.1 About FFP
11.1.1 FFP Using One NIC
11.1.2 FFP Using Multiple NICs
11.1.3 IP Forwarding
11.1.4 FFP and Packet Filtering
11.2 FFP Support in NDIS
11.3 Implementing FFP in Miniports for IP Forwarding
Chapter 12 Miniport Driver with a WDM Lower Interface
12.1 Miniport with a WDM Lower Edge
12.2 Registering Miniport Functions for WDM Lower Edge
12.3 Initializing a Miniport with a WDM Lower Edge
12.4 Issuing Commands to Communicate with Remote Devices
12.4.1 Sending Packets on a Bus
12.4.2 Receiving Packets on a Bus
12.5 Implementation Tips for WDM Lower Edge
12.6 Compile Flags for WDM Lower Edge
Chapter 13 IrDA Miniport NIC Drivers
13.1 About IrDA Miniport Drivers
13.2 IrDA Architecture
13.3 IrDA Protocol Driver
13.4 IrDA Medium Features
13.4.1 Communication Link Speeds
13.4.2 Communication Link Turnaround Times
13.4.3 Receiver Synchronization
13.5 IrLAP Frame Format
13.5.1 About IrLAP Frame Format
13.5.2 Use of Frame Information
13.5.3 Address Member
13.6 IrDA Miniport Driver Packet Coding Schemes
13.6.1 SIR Coding
13.6.2 MIR Coding
13.6.3 FIR Coding
13.7 Sending and Receiving Packe Arrays
13.8 Plug and Play
13.8.1 Non-Plug and Play External Serial-Attached SIR Adapters
13.8.2 Non-PnP Internal SIR Adapters or Internal SIR Adapters Incorrectly Exposed as Serial Ports
13.8.3 PnP External Serial-Attached SIR Adapters
13.8.4 PnP Internal SIR Adapters
13.8.5 Non-PnP Bus-Attached FIR Adapters
13.8.6 PnP Bus-Attached FIR Adapters
Part 3 Intermediate NDIS Drivers and TDI Drivers
Chapter 1 NDIS Intermediate Drivers
1.1 Intermediate Driver DriverEntry Function
1.1.1 Registering as an NDIS Intermediate Driver
1.2 Dynamic Binding in an Intermediate Driver
1.2.1 Opening an Adapter Underlying an Intermediate Driver
1.2.2 Initializing as a Miniport
1.2.3 Intermediate Driver Query and Set Operations
1.2.4 Registering an Intermediate Driver as a Connection-Oriented Client
1.3 Intermediate Driver Packet Management
1.4 Restrictions on Intermediate Drivers
1.5 Receiving Data in an Intermediate Drivers
1.5.1 Receiving Data in an Intermediate Driver with a Connectionless Lower Edge
1.5.2 Receiving Data in an Intermediate Driver with a Connection-Oriented Lower Edge
1.5.3 Indicating Receive Packets to Higher Level Drivers
1.6 Transmitting Packets through an Intermediate Driver
1.6.1 Passing Media-Specific Information
1.7 Handling PnP Events and PM Events in an Intermediate Driver
1.7.1 Handling OID_PNP_XXX Queries and Sets
1.7.2 Implementing a ProtocolPnPEvent Handler in an Intermediate Driver
1.7.3 Handling a Set Power Request
1.8 Intermediate Driver Reset Operations
1.9 Intermediate Driver Unbinding Operations
1.10 Status Indications in an Intermediate Driver
Chapter 2 NDIS Protocol Drivers
2.1 Protocol DriverEntry and Initialization
2.1.1 Registering as an NDIS Protocol Driver
2.1.2 Opening an Adapter Underlying a Protocol Driver
2.1.3 Protocol Driver Query and Set Operations
2.1.4 Registering as a Call Manager or a Connection-Oriented Client
2.2 Protocol Driver Packet Management
2.3 Dynamic binding in a Protocol Driver
2.4 Receiving Data in a Protocol Driver
2.4.1 Receiving Data in a Connectionless Protocol Driver
2.4.2 Receiving Data in a connection-Oriented Protocol Driver
2.5 Sending Protocol Driver-Originated Packets
2.5.1 Sending Packets from a Connectionless Protocol Driver
2.5.2 Sending Packets from a connection-Oriented Protocol Driver
2.6 Handling PnP Events and Power Management Events in a Protocol Driver
2.7 Protocol Driver Reset Operations
2.8 Protocol Driver Unbinding Operations
2.9 Status Indications in a Protocol Driver
Chapter 3 TDI Transports and Their Clients
3.1 The Transport Driver Interface（TDI）
3.2 TDI Device Objects
3.3 TDI File Objects
3.3.1 File Objects Represent Transport Addresses
3.3.2 File Objects Represent Connection Endpoints
3.3.3 File Objects Represent Control Channels
3.4 TDI Transport driver Routines
3.5 TDI Kernel-Mode Client Interactions
3.6 TDI Requests versus Events
Chapter 4 TDI Routines，Macros，and Callbacks
4.1 TDI Driver Initialization
4.1.1 Registering a TDI Transport Driver
4.1.2 Unloading and Deregistering a TDI Transport Driver
4.2 TDI Driver Dispatch Routines
4.3 TDI IOCTL Requests
4.4 TDI Client Callbacks
4.5 TDI Library Functions and Macros
Chapter 5 TDI Operations
5.1 Opening a Transport Address
5.2 Opening a Connection Endpoint
5.3 Packaging and Submitting IOCTL Requests
5.4 Setting and Querying Information
5.5 Making an Endpoint-to-Endpoint Connection
5.6 Sending and Receiving Connection-Oriented Data
5.7 Sending and Receiving Connectionless Data
5.8 Connection-Oriented Versus Connectionless Transfers
5.9 Requesting Transport-Specific Actions
5.10 Receiving Error Notifications
5.11 Disconnecting an Endpoint-to-Endpoint Connection
5.12 Closing a Connection Endpoint
5.13 Closing a Transport Address or Control Channel
Chapter 6 Transport Helper DLLs for Windows Sockets
6.1 Windows Sockets Helper DLL Architecture
6.2 Communicating with a WSH DLL
6.3 Configuring a WSH DLL
6.4 WSH DLL Synchronization
6.5 Supporting Connect and Disconnect Data with a WSH DLL
6.5.1 Client Applications and Connect Data
6.5.2 Server Applications and Connect Data
6.5.3 Disconnect Data
6.6 WSH DLL Function Summary
Part 4 Connection-Oriented NDIS
Chapter 1 Connection-Oriented NDIS
1.1 Connection-Oriented Environment
1.2 Using AFs, VCs, SAPs, and Parties
1.2.1 Address families
1.2.2 virtual Connections
1.2.3 SAPs
1.2.4 Parties
1.3 Quality of Service
1.4 How an MCM Differs from a Call Manager
1.4.1 Differences in Initialization
1.4.2 Differences in Calls to NdisXxx Functions
1.4.3 Differences in Virtual Connections
1.5 Connection-Oriented Timing Features
1.6 Connection-Oriented Operations
1.6.1 Summary of connection-Oriented Operations
1.6.2 Operations on address Families and SAPs
1.6.3 Operations on VCs
1.6.4 Setting Up a Call
1.6.5 Changing the QoS of an Active VC
1.6.6 Adding and Dropping Parties
1.6.7 Sending and Receiving Data
1.6.8 Tearing Down a Call
1.6.9 Obtaining and Setting Information
1.6.10 Reset
Part 5 Installing Network Components
Chapter 1 Installing Network Components
1.1 Components and Files Used to Install Network Components
1.2 Creating a Network INF File
1.2.1 Filename Conventions for Network INFs
1.2.2 Version Section for Network INF Files
1.2.3 Models Section for Network INF Files
1.2.4 DDInstall Section for Network INF Files
1.2.5 Remove Section for Network INF Files
1.2.6 ControlFlags Section for Network INF Files
1.2.7 Add-registry-Section for Network INF Files
1.2.8 DDInstall Services Section
1.2.9 NetworkProvider and PrintProvider Sections
1.2.10 Winsock Sections
1.2.11 Summary of Installation Requirements for Network Components
Chapter 12 Notify Objects for Network components
2.1 About the Notify Object
2.1.1 Notify Object diagram
2.1.2 Types of Notifications
2.1.3 Installation of the Network Component
2.1.4 removal of the Network Component
2.1.5 Upgrade to the Network Component
2.1.6 Displaying and Changing Properties
2.1.7 configuration of the Network
2.2 Creating the Notify Object
2.2.1 Loading the Notify Object DLL and Class Object
2.2.2 defining a Notify Class
2.2.3 Creating and Initializing an Instance of a Notify Object
2.2.4 Installing，Upgrading，and Removing the Component
2.2.5 Creating Property Pages for the component
2.2.6 Setting Context to Display Properties
2.2.7 Evaluating changes to Network Configuration
2.2.8 Applying Component Changes to the Registry
2.2.9 Configuring the Component’s Driver
鄂公网安备 42010302001612号 