D3DKMDT_SHADOWSURFACEDATA 结构 (d3dkmdt.h)

项目
05/18/2024

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) 请求。还会发出位块传输请求，以将数据从共享主图面传输到阴影图面。

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