D3DKMDT_STAGINGSURFACEDATA 结构 (d3dkmdt.h)

项目
02/26/2024

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 值指定。由于暂存图面的尺寸始终与后台缓冲区的尺寸匹配，因此暂存图面的当前操作不需要拉伸或收缩操作。