使用Windows Driver Kit (WDK) 10开发和调试驱动程序

Windows

Driv

需积分: 13 31 浏览量更新于2024-07-18 收藏 862KB PDF 举报

身份认证购VIP最低享 7 折!

领优惠券(最高得80元）

"Windows Driver Kit (WDK) 10 是一款与 Microsoft Visual Studio 2017 和 Windows 调试工具集结合的开发套件，提供了开发、构建、打包、部署、测试和调试驱动程序所需的全部工具。用户可以在集成环境中运行许多基本的认证测试。WDK 包括了多种技术及驱动模型的模板，如 Windows 驱动框架、USB、打印、网络和文件系统过滤器等驱动程序的模板。" 在深入探讨 Windows 驱动开发之前，首先需要了解什么是 Windows Driver Kit (WDK)。WDK 是微软提供的用于开发、测试和调试 Windows 操作系统驱动程序的重要工具集。通过集成 Visual Studio，开发者可以享受到更流畅的开发体验，同时调试工具使得问题定位和修复变得更加容易。要开始使用 WDK，你需要下载并安装它。Windows Driver Kit 提供了不同版本的下载，根据你的开发需求选择合适的版本。WDK 的"Bringup guide"将引导你完成初始设置和环境配置，确保你的开发环境能够正确运行。在开发阶段，WDK 提供了一系列的技术和驱动模型，例如： 1. **Windows Driver Frameworks (WDF)**：这是一组可扩展的库，帮助开发者创建可靠的、安全的内核模式和用户模式驱动。WDF 提供了统一的编程模型，降低了驱动开发的复杂性。 2. **USB 驱动**：WDK 支持 USB 设备驱动的开发，包括主机控制器、设备类驱动和函数驱动。对于 USB 驱动，开发者可以使用预定义的模板来快速构建驱动程序。 3. **打印驱动**：开发打印驱动涉及到设备安装、设备和驱动程序交互以及打印队列管理等方面。WDK 提供了相应的模板和指南。 4. **网络驱动**：包括 NetAdapterCx，这是一个新的客户端驱动程序模型，简化了网络适配器驱动程序的开发，同时提供了高性能和低延迟。 5. **文件系统过滤驱动**：这些驱动程序允许开发者插入到现有的文件系统操作中，实现对文件系统访问的监控或修改。 6. **其他驱动技术**：WDK 还涵盖了电池、蓝牙、显示、电源管理、GPIO、HID、智能卡等众多硬件设备的驱动开发。在测试和部署阶段，Windows Hardware Dev Center Dashboard 提供了一种方式来验证驱动程序是否符合微软的认证标准。设备和驱动安装部分讲解了如何确保驱动程序能够正确地安装在用户的计算机上。安全是驱动开发中的关键因素。Windows Driver Security 指南提供了关于编写安全代码的最佳实践，以防止驱动程序成为恶意攻击的入口点。调试是驱动开发中不可或缺的部分。Windows Debugging Tools 提供了丰富的调试工具，如 WinDbg，用于分析内存、线程、注册表等问题，帮助开发者找出并修复潜在的错误。 Windows Driver Kit 提供了一个全面的解决方案，旨在帮助开发者创建高效、稳定且安全的 Windows 驱动程序，覆盖了从驱动开发的起点到发布的全过程。通过利用 WDK，开发者可以充分利用微软提供的工具和资源，提高开发效率并保证驱动程序的质量。

资源详情

资源推荐

  
USBUSB
Media Agnostic USB 
(
MA
-
USB
)
 protocolMedia Agnostic USB 
(
MA
-
USB
)
 protocol
CALLBACK FUNCTIONS STRUCTURES
EVT_UCX_USBDEVICE_GET_CHARACTERISTIC UCX_ENDPOINT_ISOCH_TRANSFER_PATH_DELAYS
EVT_UCX_USBDEVICE_RESUME UCX_CONTROLLER_ENDPOINT_CHARACTERISTIC_PRIORITY
EVT_UCX_USBDEVICE_SUSPEND UCX_ENDPOINT_CHARACTERISTIC
EVT_UCX_ENDPOINT_GET_ISOCH_TRANSFER_PATH_DELAYS UCX_ENDPOINT_CHARACTERISTIC_TYPE
EVT_UCX_ENDPOINT_SET_CHARACTERISTIC UCX_ENDPOINT_ISOCH_TRANSFER_PATH_DELAYS
Synchronized system QPC with USB frame and microframesSynchronized system QPC with USB frame and microframes
ntddscsi.h
ntddstor.h
ntddvol.h
ntifs.h
scsi.h
storport.h
This section describes the new features for USB in Windows 10, version 1709.
The USB driver stack can send USB packets over non
-
USB physical mediums such as Wi
-
Fi by using the Media
Agnostic USB 
(
MA
-
USB
)
 protocol. To implement this feature, new programming interfaces have been released.
The new DDIs allow the driver to determine the delays associated with the
_URB_GET_ISOCH_PIPE_TRANSFER_PATH_DEL AYS. That information can be retrieved by building a new URB
request. For information about this new feature, see the following topics:
USB client drivers for Media
-
Agnostic 
(
MA
-
USB
)
_URB_GET_ISOCH_PIPE_TRANSFER_PATH_DEL AYS
USB Request Blocks 
(
URBs
)
To support MA
-
USB, the host controller driver must provide the transport characteristics by implementing specific
callback functions. The following table shows the callback functions and structures that support MA
-
USB.
There are new programming interfaces that retrieve the system query performance counter 
(
QPC
)
 value
synchronized with the frame and microframe.
This information is retrieved only when the caller enables the feature in the host controller. To enable the feature, a
host controller driver must implement the following callback functions.
EVT_UCX_CONTROLLER_GET_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC
EVT_UCX_CONTROLLER_START_TRACKING_FOR_TIME_SYNC
EVT_UCX_CONTROLLER_STOP_TRACKING_FOR_TIME_SYNC
An application can use these APIs to enable/disable the feature and retrieve the information:
WinUsb_GetCurrentFrameNumberAndQpc
WinUsb_StartTrackingForTimeSync
WinUsb_StopTrackingForTimeSync
Other drivers can send these IOCTL requests to enable/disable the feature and retrieve the information:

  
  
  
What's new in Windows 10, version 1703
AudioAudio
BluetoothBluetooth
CameraCamera
IOCTL_USB_GET_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC
IOCTL_USB_START_TRACKING_FOR_TIME_SYNC
IOCTL_USB_STOP_TRACKING_FOR_TIME_SYNC
Here are the supporting structures for synchronized system OPC with USB frame and microframes:
USB_START_TRACKING_FOR_TIME_SYNC_INFORMATION
USB_STOP_TRACKING_FOR_TIME_SYNC_INFORMATION
USB_FRAME_NUMBER_AND_QPC_FOR_TIME_SYNC_INFORMATION
IOCTL_UCMTCPCI_PORT_CONTROLLER_DISPLAYPORT_DISPLAY_OUT_STATUS_CHANGED
The IOCTL_UCMTCPCI_PORT_CONTROLLER_DISPL AYPORT_DISPL AY_OUT_STATUS_CHANGED request is a
new request in USB Type
-
C Port Controller Interface framework extension. This request notifies the client driver
that the display out status of the DisplayPort connection has changed.
Here are the structures that support the
IOCTL_UCMTCPCI_PORT_CONTROLLER_DISPL AYPORT_DISPL AY_OUT_STATUS_CHANGED request:
UCMTCPCI_PORT_CONTROLLER_DISPL AYPORT_DISPL AY_OUT_STATUS_CHANGED_IN_PARAMS
UCMTCPCI_PORT_CONTROLLER_DISPL AYPORT_DISPL AY_OUT_STATUS
This section describes new and improved features for driver development in Windows 10, version 1703.
Back to Top
The following is a list of new topics for Audio driver development in Windows 10, version 1703:
Implementing Audio Module Communication 
-
 Describes the support for communication from Universal
Windows Platform 
(
UWP
)
 apps to kernel mode audio device drivers.
New DDIs and properties reference topics to support APO Module Communications discovery:
KSPROPSETID_AudioModule 
-
 A new KS Property Set that defines three properties specific to audio
modules.
KSPROPERTY_AUDIOMODULE_COMMAND property 
-
 Allows Audio Module clients to send custom
commands to query and set parameters on Audio Modules.
IPortClsNotifications 
-
 New Port Class Notifications that provide notification helpers to miniports, to
support audio module communication.
The following is a list of updates to Bluetooth in Windows 10 version 1703:
Hands
-
Free Profile 
(
HFP
)
 1.6 specification with Wideband speech on Windows 10 for desktop editions.
Support for Call Control APIs on Windows 10 for desktop editions.
Support for GATT Server, Bluetooth LE Peripheral and non
-
paired support for Bluetooth LE. See our developer
post for more details.
For more information about what's new for Bluetooth, see Bluetooth and Bluetooth LE pre
-
pairing.
The following is a list of updates to Camera driver development in Windows 10, version 1703:
USB Video Class 
(
VCC
)
 driver implementation guide
Microsoft extensions to USB Video Class 1.5 specification

  
  
  
  
  
  
Windows kernelWindows kernel
Mobile broadbandMobile broadband
NetworkingNetworking
POSPOS
USBUSB
What's new in Windows 10, version 1607
AudioAudio
Device transform manager 
(
DTM
)
 events
IMFDeviceTransform interface
KSCategory_Xxx Device Interface Classes
KSCATEGORY_SENSOR_CAMERA
KSCATEGORY_VIDEO_CAMERA
Windows Kernel
-
Mode Process and Thread Manager 
-
 Starting in Windows 10 version 1703, the Windows
Subsystem for Linux 
(
WSL
)
 enables a user to run native Linux ELF64 binaries on Windows, alongside other
Windows applications. For more information about WSL architecture and the user
-
mode and kernel
-
mode
components that are required to run the binaries, see the posts on the Windows Subsystem for Linux blog.
Updates to Mobile Broadband 
(
MB
)
 include improved LTE attach features, support for Multi
-
SIM Operations,
support for provisioning contexts into the modem, support for the Specific Absorption Rate platform, and support
for network blacklisting.
Updates to Mobile Operator Scenarios 
(
MOs
)
 include a new database format called COSA FAQ, for MOs to
provision Windows Desktop MB devices. See these topics for more updates:
Planning your COSA/APN database submission
Submitting the COSA/APN database update
Testing your COSA/APN database submission
Updates to Networking driver development in Windows 10, version 1703 includes a new type of socket called
Stream Sockets, which support Linux networking applications on Windows. See Winsock Kernel for more info.
New functions and structures include WskConnectEx, WskListen, WSK_CLIENT_STREAM_DISPATCH, and
WSK_PROVIDER_STREAM_DISPATCH
The following is a list of new topics for POS in Windows 10, version 1703:
Bluetooth barcode scanner UUIDs
BarcodeSymbologyDecodeLenthType enumeration
BarcodeSymbologyAttributesData structure
There is a new Gs1DWCode symbology to the BarcodeSymbology enumeration.
Windows 10 version 1703 provides a new class extension 
(
UcmTcpciCx.sys
)
 that supports the Universal Serial Bus
Type
-
C Port Controller Interface Specification. A USB Type
-
C connector driver does not need to maintain any
internal PD/Type
-
C state. The complexity of managing the USB Type
-
C connector and USB Power Delivery 
(
PD
)
state machines is handled by the system. You only need to write a client driver that communicates hardware events
to the system through the class extension. For more information, see USB Type
-
C Controller Interface driver class
extensions reference.
Back to Top
This section describes new features and improvements for driver development in Windows 10, version 1607.
The following is a list of new topics for Audio driver development in Windows 10, version 1607.

  
  
  
  
  
  
  
CameraCamera
LocationLocation
PrintPrint
WLANWLAN
What's new in Windows 10, version 1507
BluetoothBluetooth
Buses and PortsBuses and Ports
CameraCamera
Windows Audio Architecture
Structures and properties to better support the Cortana experience:
PKEY_AudioEndpoint_Default_VolumeInDb 
–
 An INF key that provides the user a better experience when
appropriate gain or attenuation is applied to the audio signal.
KSPROPERTY_AUDIO_MIC_SENSITIVITY
KSPROPERTY_AUDIO_MIC_SNR
KSAUDIO_PACKETSIZE_CONSTRAINTS2
Camera driver development in Windows 10, version 1607 includes new and updated topics to support Windows
Hello and face authentication:
Windows Hello camera driver bring up guide
Extended camera controls
KSPROPERTY_CAMERACONTROL_EXTENDED_FACEAUTH_MODE
Location driver development in Windows 10, version 1607 includes the following new GNSS Breadcrumb DDIs:
GNSS_BREADCRUMB_LIST
GNSS_BREADCRUMB_V1
GNSS_BREADCRUMBING_ALERT_DATA
GNSS_BREADCRUMBING_PARAM
IOCTL_GNSS_LISTEN_BREADCRUMBING_ALERT
IOCTL_GNSS_POP_BREADCRUMBS
IOCTL_GNSS_START_BREADCRUMBING
IOCTL_GNSS_STOP_BREADCRUMBING
Printer driver development in Windows 10, version 1607 includes JSConstraintsDebug, a command
-
line tool that
provides debugging support for JavaScript Constraints while developing a V4 printer driver.
In Windows 10, version 1607, there are new and updated topics for WL AN Device Driver Interface 
(
WDI
)
 version
1.0.21. For details, see WDI doc change history.
Back to Top
This section describes new and updated features for driver development in Windows 10.
In Windows 10, new Microsoft
-
defined Bluetooth HCI extensions have been added.
Driver programming interfaces and in
-
box drivers for Simple Peripheral Bus 
(
SPB
)
 such as I2C and SPI, and GPIO
are part of OneCoreUAP
-
based editions of Windows. Those drivers will run on both Windows 10 for desktop
editions and Windows 10 Mobile, as well as other Windows 10 versions.
The camera driver DDIs have converged into a Universal Windows driver model, including new camera DDIs.
Additional features include:

  
    
  
  
  
  
  
CellularCellular
DisplayDisplay
Human Interface Device 
(
HID
)
Human Interface Device 
(
HID
)
LocationLocation
Near Field Communication 
(
NFC
)
Near Field Communication 
(
NFC
)
NetworkingNetworking
PrintPrint
Digital video stabilization
Variable frame rate
Face detection
Video high dynamic range 
(
HDR
)
Optical stabilization
Scene analysis: photo HDR, flash no flash, ultra low light
Capture stats: metadata framework/attributes, histograms
Smooth zoom
Hardware optimization hints
Camera profiles
Cellular architecture and implementation for Windows 10 has been updated.
The display driver model from Windows 8.1 and Windows Phone have converged into a unified model for
Windows 10.
A new memory model is implemented that gives each GPU a per
-
process virtual address space. Direct addressing
of video memory is still supported by WDDMv2 for graphics hardware that requires it, but that is considered a
legacy case. IHVs are expected to develop new hardware that supports virtual addressing. Significant changes have
been made to the DDI to enable this new memory model.
The new Virtual HID Framework 
(
VHF
)
 eliminates the need for writing a kernel
-
mode transport minidriver. The
framework comprises a Microsoft
-
provided static library 
(
Vhfkm.lib
)
 that exposes programming elements used by
your driver. It also includes a Microsoft
-
provided in
-
box driver 
(
Vhf.sys
)
 that enumerates one or more child devices
and proceeds to build a virtual Human Interface Device 
(
HID
)
 tree.
Write a HID source driver by using Virtual HID Framework 
(
VHF
)
Virtual HID Framework Callback Functions
Virtual HID Framework Methods
Virtual HID Framework Structures
The Global Navigation Satellite System 
(
GNSS
)
 driver DDIs have converged to a GNSS Universal Windows driver
model 
(
UMDF 2.0
)
.
The NFC DDIs have a new converged driver model to support mobile and desktop solutions.
NFC Class Extension: A new NFC class extension driver is available. The NFC class extension driver implements all
of the Windows
-
defined DDIs to interact with the NFC controller, secure elements, and remote RF endpoints.
The new PacketDirect Provider Interface 
(
PDPI
)
 is available as an extension to the existing NDIS miniport driver
model. The PDPI provides an I/O model that allows applications to manage their own buffers, poll processors, and
directly manage sending and receiving packets over a miniport adapter. The combination of these capabilities allow
the application to completely control its own contexts leading to a much higher packet
-
per
-
second 
(
pps
)
 ratio.
The print driver is updated with v4 Print driver improvements and changes to support wireless printing from
mobile devices, as well as the following: