D3DKMDT_GDISURFACETYPE枚举（d3dkmdt.h）

项目
02/06/2025

D3DKMDT_GDISURFACETYPE枚举指示桌面窗口管理器（DWM）用于重定向的可锁定图面的类型。

语法

typedef enum _D3DKMDT_GDISURFACETYPE {
  D3DKMDT_GDISURFACE_INVALID,
  D3DKMDT_GDISURFACE_TEXTURE,
  D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE,
  D3DKMDT_GDISURFACE_STAGING,
  D3DKMDT_GDISURFACE_LOOKUPTABLE,
  D3DKMDT_GDISURFACE_EXISTINGSYSMEM,
  D3DKMDT_GDISURFACE_TEXTURE_CPUVISIBLE,
  D3DKMDT_GDISURFACE_TEXTURE_CROSSADAPTER,
  D3DKMDT_GDISURFACE_TEXTURE_CPUVISIBLE_CROSSADAPTER
} D3DKMDT_GDISURFACETYPE;

常数


`D3DKMDT_GDISURFACE_INVALID` 驱动程序不应看到此值。
`D3DKMDT_GDISURFACE_TEXTURE` 指示图面具有以下属性：它具有一级纹理。 CPU 不可见，视频内存管理器会将其创建为共享图面。它由用户模式驱动程序打开，在 DWM 组合期间用作纹理。它由用户模式驱动程序用作 DirectX 呈现的呈现目标。它用作 GDI 硬件加速作中的源或目标图面。
`D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE` 指示图面具有以下属性：它对 CPU 可见，CPU 将广泛使用。分配必须是线性格式，并且采用缓存一致的 GPU 光圈段。它用作 GDI 硬件加速作中的源图面。它用作 bitblt（仅复制）GDI作中的目标图面。其音调必须由显示微型端口驱动程序返回。其音调值和图面地址必须与 DXGK_PRESENTATIONCAPS 结构 AlignmentShift 成员的值对齐（即 DXGK_DRIVERCAPS->PresentationCaps.AlignmentShift）。
`D3DKMDT_GDISURFACE_STAGING` 指示图面具有以下属性： CPU 不可见。它用作 GDI 硬件加速作中的源或目标图面。它用作 GDI bitblt（仅复制）作中的源或目标图面。
`D3DKMDT_GDISURFACE_LOOKUPTABLE` 指示图面具有以下属性： CPU 不可见。它仅在处理由 ClearTypeBlend 和 OpCode指定的命令时使用。DXGK_RENDERKM_COMMAND 结构的DXGK_GDIOP_BITBLT（仅复制）成员。格式由 D3DDDIFORMAT 枚举的D3DDDIFMT_A8值定义。伽玛查找分配创建一次，在初始化后永远不会更改。通过从D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE图面发出 DXGK_RENDERKM_COMMAND>Opcode.DXGK_GDIOP_BITBLT 命令，以D3DDDIFMT_A8格式初始化分配。
`D3DKMDT_GDISURFACE_EXISTINGSYSMEM` 指示图面具有以下属性： CPU 可见。分配必须是线性格式，并且采用缓存一致的 GPU 光圈段。其音调值和图面地址必须与 DXGK_PRESENTATIONCAPS 结构 AlignmentShift 成员的值对齐（即 DXGK_DRIVERCAPS->PresentationCaps.AlignmentShift）。图面地址传递到驱动程序。此值与D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE值相同。
`D3DKMDT_GDISURFACE_TEXTURE_CPUVISIBLE` 保留供系统使用。请勿在驱动程序中使用此值。从 Windows 8 开始支持。
`D3DKMDT_GDISURFACE_TEXTURE_CROSSADAPTER` 指示图面具有以下属性： CPU 不可见，视频内存管理器会将其创建为共享的跨适配器图面。它的音调必须由音调D3DKMDT_GDISURFACEDATA 结构的成员中的显示微型端口驱动程序返回。音调和高度必须具有交叉适配器资源所需的对齐方式。可以使用 D3DKMT_CROSS_ADAPTER_RESOURCE_PITCH_ALIGNMENT 和 D3DKMT_CROSS_ADAPTER_RESOURCE_HEIGHT_ALIGNMENT 常量来验证驱动程序是否返回交叉适配器资源的正确音调和高度。这些常量在 D3dukmdt.h 中定义。从 Windows 8.1 开始支持。
`D3DKMDT_GDISURFACE_TEXTURE_CPUVISIBLE_CROSSADAPTER` 保留供系统使用。请勿在驱动程序中使用此值。从 Windows 8.1 开始支持。