PFND3DWDDM1_3DDI_SETMARKERMODE回调函数 (d3d10umddi.h)
通知用户模式显示驱动程序,它应支持 Windows 事件跟踪(ETW)标记事件的类型。 必须由 Windows 显示驱动程序模型 (WDDM) 1.3 及更高版本驱动程序实现。
语法
PFND3DWDDM1_3DDI_SETMARKERMODE Pfnd3dwddm13DdiSetmarkermode;
void Pfnd3dwddm13DdiSetmarkermode(
D3D10DDI_HDEVICE hDevice,
D3DWDDM1_3DDI_MARKER_TYPE Type,
UINT Flags
)
{...}
参数
hDevice
显示设备的句柄(图形上下文)。
Type
D3DWDDM1_3DDI_MARKER_TYPE 枚举中的一个值,该值指示驱动程序应支持的标记事件的类型。
Flags
一个 UINT 值,该值指示驱动程序是否应在命令缓冲区中提供自定义信息。 如果设置为 D3DWDDM1_3DDI_SETMARKERMODE_CUSTOMDRIVEREVENTS,驱动程序应使用自定义事件信息批注和检测命令缓冲区。 否则,驱动程序不应批注命令缓冲区。
批注可以采用 English-US 区域设置中的文本字符串的形式,也可以以索引值的形式呈现到字符串表中的位置。 对于后一个选项,驱动程序还必须实现描述索引值指示的字符串的函数。
返回值
没有
言论
驱动程序可以使用 pfnSetErrorCb 回调函数来设置错误代码。
在用户模式驱动程序中设置配置文件类型标记事件(由 D3DWDDM1_3DDI_MARKER_TYPE_PROFILE 类型指示)时,请遵循以下准则:
- 使用轻量级检测,该检测不会与图形命令边界产生强关联。
- 驱动程序必须能够采样图形管道末尾的 GPU 时间戳。
- 不要使用对图形管道造成高性能负担的采样命令,例如等待空闲命令。 为了能够检测配置文件类型的标记事件,驱动程序不必刷新管道或缓存。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 8.1、WDDM 1.3 及更高版本 |
支持的最低服务器 | Windows Server 2012 R2 |
目标平台 | 桌面 |
标头 | d3d10umddi.h (包括 D3d10umddi.h) |