D3DKMDT_SHADOWSURFACEDATA结构（d3dkmdt.h）

项目
02/06/2025

D3DKMDT_SHADOWSURFACEDATA结构描述可锁定的阴影表面，它与给定显示模式的格式和分辨率的主图面匹配。

语法

typedef struct _D3DKMDT_SHADOWSURFACEDATA {
  [in]  UINT         Width;
  [in]  UINT         Height;
  [in]  D3DDDIFORMAT Format;
  [out] UINT         Pitch;
} D3DKMDT_SHADOWSURFACEDATA;

成员

[in] Width

图面的宽度（以像素为单位）。驱动程序返回宽度值。

[in] Height

图面的高度（以像素为单位）。驱动程序返回高度值。

[in] Format

指示图面像素格式的 D3DDDIFORMAT类型值。驱动程序返回格式值。

[out] Pitch

图面的宽度（以字节为单位）。驱动程序必须返回音调值，因为阴影表面是可锁定的。

言论

D3DKMDT_SHADOWSURFACEDATA结构由 Microsoft DirectX 图形内核子系统在调用显示微型端口驱动程序的 DxgkDdiGetStandardAllocationDriverData 函数传递，以生成可锁定阴影表面的说明。 DirectX 图形内核子系统使用调用显示微型端口驱动程序的 DxgkDdiCreateAllocation 函数的说明来创建可锁定的阴影图面。

CPU 将绘制到锁定的阴影图面中，解锁阴影图面，然后通过 DxgkDdiPresent 函数从阴影图面向匹配的共享主图面发出位块传输（bitblt）请求。还会发出位块传输请求，以将数据从共享主图面传输到阴影图面。

从或复制到阴影图面时不需要颜色转换、拉伸或收缩作，因为阴影和共享主图面的源和目标格式和尺寸始终匹配。