用户模式驱动程序日志记录

  • 项目

若要更易操作的视频内存细分，Windows 显示驱动程序模型 (WDDM) 驱动程序必须公开 Microsoft Direct3D 资源和视频内存分配之间的关系。 从Windows 8引入额外的用户模式驱动程序 (UMD) 日志记录接口开始，可以实现此操作。 将此信息添加到 Windows (ETW) 跟踪的事件跟踪中后，可以从 API 的角度查看视频内存分配。

最低 WDDM 版本：1.2

最低 Windows 版本：8

驱动程序实现 - 完整图形和仅呈现：必需

WHCK 要求和测试： Device.Graphics¦UMDLogging

对于开发人员来说，UMD 日志记录可以阐明目前很难看到的内存成本，例如内部碎片或快速丢弃图面的影响。 它使 Microsoft 能够更好地与提供性能问题分析跟踪的客户和合作伙伴合作。 具体而言，此功能有助于克服调查内存相关性能问题时常见的阻塞点：应用程序使用的工作集太大，但你无法确定导致此问题的 API 资源或调用。

驱动程序必须通过实现 UMD ETW 接口来公开 Direct3D 资源和视频内存分配之间的关系。 除了日志记录事件之外，驱动程序还必须能够在任何时间点报告资源和分配之间的所有现有映射。

UMD 驱动程序分配日志记录 DDI

用户模式驱动程序分配日志记录设备驱动程序接口 (DDI) 提供事件跟踪 for Windows (ETW) 内核级跟踪设施下的事件，其中显示了哪些 API 资源与 Microsoft DirectX 图形内核子系统 (Dxgkrnl.sys) 中的内核分配相关联。

可以使用 DDI 发现内部内存碎片或快速丢弃图面的影响，为 Microsoft 提供更好的跟踪信息，以帮助你识别性能问题，并帮助确定应用的资源或 API 调用何时导致其使用过大的工作内存集。

使用 Umdprovider.h 标头中的以下函数、枚举和结构在用户模式显示驱动程序中记录事件：

另请参阅 Umdetw.h 标头。

硬件认证要求

有关硬件设备在实现此功能时必须满足的要求的信息，请参阅 Device.Graphics ¦ UMDLogging 上的相关 WHCK 文档。

有关随 Windows 8 添加的功能的回顾，请参阅 WDDM 1.2 功能。