适用于 Windows 10 的驱动程序开发添加版本1709Driver development additions for Windows 10, version 1709

本主题提供有关 Windows 10 版本1709中的 Windows 驱动程序开发功能和更新的信息。This topic provides information about the features and updates to Windows driver development in Windows 10, version 1709.

Windows 10 版本1709中更新的功能区域Feature areas updated in Windows 10, version 1709

以下功能在 Windows 10 版本1709中记录了更新。The following features have documented updates in Windows 10, version 1709.

Windows 调试器Windows debugger

下面是 Windows 10 版本 1709 中调试器的新内容集列表:The following is a list of new content sets for the Debugger in Windows 10, version 1709:

驱动程序验证程序Driver Verifier

驱动程序验证程序包含以下技术的新驱动程序验证规则:Driver verifier includes new driver validation rules for the following technologies:

通用 Windows 驱动程序Universal Windows drivers

下面是 Windows 10 版本 1709 中通用驱动程序的新增功能列表:The following is a list of new features to Universal Drivers in Windows 10, version 1709:

  • 使用 Windows 更新来更新设备固件 - 介绍如何使用 Windows 更新 (WU) 服务更新可移动设备或机箱内部设备的固件。Updating Device Firmware using Windows Update - Describes how to update a removable or in-chassis device's firmware by using the Windows Update (WU) service.
  • Reg2inf - 驱动程序包 INF 注册表转换工具 (reg2inf.exe) 可将注册表项及其值或者用于实现 DLL RegisterServer 例程的 COM.dll 转换成一组 INF AddReg 指令。Reg2inf - The Driver Package INF Registry Conversion Tool (reg2inf.exe) converts a registry key and its values or a COM .dll implementing a DLL RegisterServer routine, into a set of INF AddReg directives. 这些指令包含在驱动程序包 INF 文件中。These directives are included in the driver package INF file.

下面是 Windows 10 版本 1709 中通用驱动程序的更新列表:The following is a list of updates to Universal Drivers in Windows 10, version 1709:

WPP 软件跟踪WPP Software Tracing

WPP 软件跟踪引入了一项新功能:即时 Trace 记录器,在 Windows 10 中,版本1709。WPP Software Tracing introduces a new feature: Inflight Trace Recorder, in Windows 10, version 1709. 如果驱动程序启用了 WPP 跟踪和 WPP 记录器,则会自动启用跟踪日志记录,你无需启动或停止跟踪会话即可轻松查看消息。If the driver enables WPP tracing and WPP Recorder, trace logging is turned on automatically and you can easily view messages without starting or stopping trace sessions. 若要对日志进行更细微的控制,WPP 记录器允许 KMDF 驱动程序创建和管理自定义缓冲区。For more fine tuned control over the log, WPP Recorder allows a KMDF driver to create and manage custom buffers.

音频Audio

下面是 Windows 10 版本 1709 中 Windows 音频驱动程序开发的更新列表:The following is a list of updates to Windows Audio driver development in Windows 10, version 1709:

  • 新的配置和查询音频设备模块New Configure and query audio device modules
  • 语音激活做了大量更新Extensive updates to voice activation
    • 有关仅限链接和关键字激活的更多详细信息More details on chained and keyword only activation
    • 新的词汇表A new glossary of terms
    • 有关训练和识别的更多信息,例如引脚和音频格式信息Additional information on training and recognition, such as pin and audio format information
    • 更新的关键字系统概述An updated keyword system overview
    • 有关语音唤醒的更新信息Updated information on wake on voice

ACPIACPI

下面列出了新的高级配置和电源接口(ACPI) DDIs,支持 Windows 10 1709 版中的输入/输出缓冲区。The following is a list of new Advanced Configuration and Power Interface (ACPI) DDIs to support input/output buffers in Windows 10, version 1709.

生物识别Biometric

Windows 10 版本1709中引入的 Windows 生物识别驱动程序有新的签名要求。There were new signing requirements for Windows Biometric Drivers introduced in Windows 10, version 1709. 有关详细信息,请参阅为 WBDI 驱动程序签名For more information, see Signing WBDI Drivers.

显示Display

Windows 10 版本1709中的 Windows 显示器驱动程序开发中引入了以下新功能。The following new features were introduced for Windows Display driver development in Windows 10, version 1709.

  • 显示色彩空间转换 DDI 针对合成后显示管道中应用的色彩空间转换提供更高的控制度。Display ColorSpace Transform DDIs provide additional control over color space transforms applied in the post-composition display pipeline.
  • D3D12 复制队列时间戳查询功能可让应用程序针对 COPY 命令列表/队列发出时间戳查询。The D3D12 Copy Queue Timestamp Queries feature will allow applications to issue timestamp queries on COPY command lists/queues. 这些时间戳的指定运行方式与其他引擎中的时间戳相同。These timestamps are specified to function identically to timestamps on other engines.
  • 通过以下方式增强了视频与 Direct3D12 运行时的集成:Enhanced Video integration into Direct3D12 Runtime through:
    1. 硬件加速的视频解码Hardware accelerated video decoding
    2. 内容保护Content protection
    3. 视频处理Video processing

硬件通知Hardware notifications

Windows 10 版本1709添加了对硬件无关通知组件(例如 Led 和振动机制)的支持。Windows 10, version 1709 added support for hardware-agnostic notification components such for hardware such as LEDs and vibration mechanisms. 有关更多信息,请参阅:For more information, see:

Windows 内核Windows kernel

在 Windows 10 版本 1709 中,为驱动程序的 Windows 内核添加了多个新例程。In Windows 10, version 1709, several new routines to the Windows Kernel for drivers have been added.

移动宽带Mobile broadband

对于 windows 10 版本1709中的驱动程序开发,为 Windows Mobile 宽带和移动运营商方案添加了以下功能:The following features were added for Windows Mobile Broadband and Mobile Operator Scenarios for driver development in Windows 10, version 1709:

在 Windows 10 版本 1709 中,桌面版 COSA 文档已更新,包括新的品牌相关字段。In Windows 10, version 1709, the desktop COSA documentation was updated to include new branding-related fields. 有关对移动运营商方案所做的其他更改,请参阅已弃用的功能列表。See the list of deprecated features for other changes to Mobile Operator Scenarios.

网络Networking

Windows 10 版本1709中添加了 Windows 网络驱动程序开发的这些新功能和改进。These new features and improvements for Windows Networking driver development were added in Windows 10, version 1709.

下面是 NDIS 的新增功能和已更新功能列表:The following is a list of new and updated features for NDIS:

虚拟化 PCIVirtualized PCI

在 Windows 10 版本1709中,添加了新的编程接口,用于写入符合 PCI Express 单根 i/o 虚拟化(SR-IOV)规范的设备的物理功能驱动程序。In Windows 10, version 1709, new programming interfaces for writing a Physical Function driver for devices that conform to the PCI Express Single-Root I/O Virtualization (SR-IOV) specification were added. 接口在 Pcivirt.h 中声明。The interfaces are declared in Pcivirt.h. 有关详细信息,请参阅 PCI 虚拟化For more information, see PCI virtualization.

脉冲宽度调制控制器Pulse Width Modulation Controllers

在 Windows 10 版本 1709 中,若要提供对已映射到 SoC 地址空间的 SoC 和内存中的脉宽调制 (PWM) 控制器的访问,需要编写一个内核模式驱动程序。In Windows 10, version 1709, to provide access to a Pulse width modulation (PWM) controller that is part of the SoC and memory-mapped to the SoC address space, you need to write a kernel-mode driver. 有关详细信息,请参阅 SoC 中 PWM 模块的 PWM 驱动程序For more information, see PWM driver for an on-SoC PWM module.

若要分析和验证引脚路径和提取引脚编号,内核模型驱动程序应使用 PwmParsePinPathTo parse and validate pin paths and extract the pin number, kernel mode drivers should use PwmParsePinPath.

应用可以通过发送 PWM IOCTL 请求,将请求发送到控制器驱动程序。An app can send requests to the controller driver by sending PWM IOCTLs requests.

文件系统和存储File Systems and Storage

Windows 10 版本 1709 的文件系统和存储中添加了 ufs.h 标头,以提供对通用闪存存储的额外支持。In File Systems and Storage, the ufs.h header was added in Windows 10, version 1709 to provide additional support to Universal Flash Storage.

Posix 更新包括新的 deleterename 函数。Posix updates include new functions delete and rename.

下面是 Windows 10 版本 1709 中已更新的标头列表:The following is a list of headers that were updated in Windows 10, version 1709:

  • ata.hata.h
  • fltKernel.hfltKernel.h
  • minitape.hminitape.h
  • ntddscsi.hntddscsi.h
  • ntddstor.hntddstor.h
  • ntddvol.hntddvol.h
  • ntifs.hntifs.h
  • scsi.hscsi.h
  • storport.hstorport.h

USBUSB

在 Windows 10 版本1709中添加了这些新的 USB 功能。These new features for USB were added in Windows 10, version 1709.

不区分媒体的 USB (MA-USB) 协议Media Agnostic USB (MA-USB) protocol

USB 驱动程序堆栈可以使用不区分媒体的 USB (MA-USB) 协议,通过非 USB 物理媒体(例如 Wi-Fi)发送 USB 数据包。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. 新的 DDI 可让驱动程序确定与 _URB_GET_ISOCH_PIPE_TRANSFER_PATH_DELAYS 关联的延迟。The new DDIs allow the driver to determine the delays associated with the _URB_GET_ISOCH_PIPE_TRANSFER_PATH_DELAYS. 可以通过生成新的 URB 请求来检索该信息。That information can be retrieved by building a new URB request. 有关此新增功能的信息,请参阅以下主题:For information about this new feature, see the following topics:

若要支持 MA-USB,主控制器驱动程序必须通过实现特定的回调函数来提供传输特征。To support MA-USB, the host controller driver must provide the transport characteristics by implementing specific callback functions. 下表显示了支持 MA-USB 的回调函数和结构。The following table shows the callback functions and structures that support MA-USB.

回调函数Callback Functions 结构Structures
EVT_UCX_USBDEVICE_GET_CHARACTERISTICEVT_UCX_USBDEVICE_GET_CHARACTERISTIC UCX_ENDPOINT_ISOCH_TRANSFER_PATH_DELAYSUCX_ENDPOINT_ISOCH_TRANSFER_PATH_DELAYS
EVT_UCX_USBDEVICE_RESUMEEVT_UCX_USBDEVICE_RESUME UCX_CONTROLLER_ENDPOINT_CHARACTERISTIC_PRIORITYUCX_CONTROLLER_ENDPOINT_CHARACTERISTIC_PRIORITY
EVT_UCX_USBDEVICE_SUSPENDEVT_UCX_USBDEVICE_SUSPEND UCX_ENDPOINT_CHARACTERISTICUCX_ENDPOINT_CHARACTERISTIC
EVT_UCX_ENDPOINT_GET_ISOCH_TRANSFER_PATH_DELAYSEVT_UCX_ENDPOINT_GET_ISOCH_TRANSFER_PATH_DELAYS UCX_ENDPOINT_CHARACTERISTIC_TYPEUCX_ENDPOINT_CHARACTERISTIC_TYPE
EVT_UCX_ENDPOINT_SET_CHARACTERISTICEVT_UCX_ENDPOINT_SET_CHARACTERISTIC UCX_ENDPOINT_ISOCH_TRANSFER_PATH_DELAYSUCX_ENDPOINT_ISOCH_TRANSFER_PATH_DELAYS

系统 QPC 与 USB 帧和微帧同步Synchronized system QPC with USB frame and microframes

添加了新的编程接口,用于检索与帧和 microframe 同步的系统查询性能计数器(QPC)值。New programming interfaces were added 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.

应用程序可以使用以下 API 来启用/禁用该功能以及检索信息:An application can use these APIs to enable/disable the feature and retrieve the information:

其他驱动程序可以发送以下 IOCTL 请求来启用/禁用该功能以及检索信息:Other drivers can send these IOCTL requests to enable/disable the feature and retrieve the information:

这些支持结构适用于带有 USB 帧和 microframes 的同步系统 OPC:These supporting structures are for synchronized system OPC with USB frame and microframes:

IOCTL_UCMTCPCI_PORT_CONTROLLER_DISPLAYPORT_DISPLAY_OUT_STATUS_CHANGEDIOCTL_UCMTCPCI_PORT_CONTROLLER_DISPLAYPORT_DISPLAY_OUT_STATUS_CHANGED

IOCTL_UCMTCPCI_PORT_CONTROLLER_DISPLAYPORT_DISPLAY_OUT_STATUS_CHANGED 请求是 USB 类型 C 端口控制器接口框架扩展中的新请求。The IOCTL_UCMTCPCI_PORT_CONTROLLER_DISPLAYPORT_DISPLAY_OUT_STATUS_CHANGED request is a new request in USB Type-C Port Controller Interface framework extension. 此请求向客户端驱动程序告知 DisplayPort 连接的显示输出状态已更改。This request notifies the client driver that the display out status of the DisplayPort connection has changed.

这些结构支持 IOCTL_UCMTCPCI_PORT_CONTROLLER_DISPLAYPORT_DISPLAY_OUT_STATUS_CHANGED 请求:These structures support the IOCTL_UCMTCPCI_PORT_CONTROLLER_DISPLAYPORT_DISPLAY_OUT_STATUS_CHANGED request: