D3DKMDT_STAGINGSURFACEDATA结构（d3dkmdt.h）

2025-02-06

D3DKMDT_STAGINGSURFACEDATA结构描述了数据从应用程序的后台缓冲区传输到的可锁定暂存图面。

语法

typedef struct _D3DKMDT_STAGINGSURFACEDATA {
  [in]  UINT Width;
  [in]  UINT Height;
  [out] UINT Pitch;
} D3DKMDT_STAGINGSURFACEDATA;

成员

[in] Width

暂存缓冲区的宽度（以像素为单位）。

[in] Height

暂存缓冲区的高度（以像素为单位）。

[out] Pitch

暂存缓冲区的宽度（以字节为单位）。驱动程序必须返回音调值，因为暂存缓冲区是可锁定的。

言论

D3DKMDT_STAGINGSURFACEDATA结构由 Microsoft DirectX 图形内核子系统在调用显示微型端口驱动程序的 DxgkDdiGetStandardAllocationDriverData 函数传递，以生成可锁定暂存图面的说明。图形子系统调用显示微型端口驱动程序的 DxgkDdiPresent 函数发出位块传输（bitblt）请求，以将数据从应用程序的后台缓冲区传输到暂存图面。然后，临时图面被 CPU 锁定并读取。

当无法将直接位块传输到主图面时（例如，在多监视器或子画面情况下），可能会为当前作创建暂存图面。

此暂存图面始终创建为每色 8 位 RGB 像素格式（由 D3DDDIFORMAT 枚举中的D3DDDIFMT_X8R8G8B8值指定）。由于暂存图面的尺寸始终与后台缓冲区的维度匹配，因此当前作不需要拉伸或收缩作到暂存图面。