DXGK_GDIARG_BITBLT 结构 (d3dkmddi.h)

项目
06/10/2023

DXGK_GDIARG_BITBLT结构描述了 GDI 硬件加速位块传输 (bitblt) 不拉伸的特征。

语法

typedef struct _DXGK_GDIARG_BITBLT {
  [in] RECT SrcRect;
  [in] RECT DstRect;
       UINT SrcAllocationIndex;
       UINT DstAllocationIndex;
       UINT NumSubRects;
       RECT *pSubRects;
       WORD Rop;
       WORD Rop3;
       UINT SrcPitch;
       UINT DstPitch;
} DXGK_GDIARG_BITBLT;

成员

[in] SrcRect

定义要复制的矩形区域的 RECT 结构。此矩形在源图面的坐标系中指定，由两个点定义：左上角和右下角。定义矩形的两个点始终按顺序排列。

源矩形可以超出源图面的边界。

此矩形映射到 DstRect 定义的目标矩形。 SrcRect 用于将子矩形从源空间转换为目标空间。

有关详细信息，请参见“备注”部分。

[in] DstRect

定义要修改的矩形区域的 RECT 结构。此矩形在目标图面的坐标系中指定，由两个点定义：左上角和右下角。矩形右下角排他;也就是说，其下边缘和右边缘不是位块传输的一部分。定义矩形的两个点始终按顺序排列。

DstRect 定义的目标矩形可以超出目标图面的边界，但子矩形不能。此外，保证所有子矩形都适合在目标图面内。子矩形可以由小于目标矩形的边框进一步约束。

有关详细信息，请参见“备注”部分。

SrcAllocationIndex

[in]分配列表中元素的索引，指定 SrcRect 源矩形所引用的分配。

DstAllocationIndex

[in]分配列表中元素的索引，指定 DstRect 目标矩形所引用的分配。

NumSubRects

[in]目标图面空间中由 DstRect 目标矩形绑定的子矩形数。

pSubRects

[in]指向目标图面空间中由 DstRect 目标矩形绑定的子矩形的指针。

Rop

[in]一个 8 位值，该值指定由 DXGK_GDIROP_BITBLT 枚举的常量值定义的 ROP (ROP ) 的 GDI 光栅操作。

Rop3

[in]一个 8 位值，指定三元 GDI 光栅操作 (ROP3) ，该操作将画笔、源位图和目标位图组合在 256 种可能的组合之一中。仅当驱动程序在DXGK_PRESENTATIONCAPS结构中设置了 SupportAllBltRops 成员时，才会处理这种类型的光栅操作。

SrcPitch

[in]源图面的间距（以字节为单位）。有关使用音调的详细信息，请参阅备注部分。

DstPitch

[in]目标图面的间距（以字节为单位）。有关使用音调的详细信息，请参阅备注部分。

注解

SrcPitch 和 DstPitch 间距值必须分别用于确定 SrcRect 和 DstRect 矩形的字节位置，以便D3DKMDT_GDISURFACETYPE类型的以下分配：

D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE

D3DKMDT_GDISURFACE_EXISTINGSYSMEM

对于其他分配类型，应忽略音调。

根据DXGK_PRESENTATIONCAPS结构 (（即DXGK_DRIVERCAPS）的 AlignmentShift成员，保证在位块传输中对齐间距。PresentationCaps.AlignmentShift) 。

如果矩形由左、上) 和右下) (坐标 (处的两个像素定义，则第一个像素的地址为：

Allocation.BaseAddress + (top * Pitch) + (left * 4)

矩形最后一个像素的地址为：

Allocation.BaseAddress + ((bottom - 1) * Pitch) + ((right - 1) * 4)

将子矩形转换为源图面空间时，保证结果在源图面内。此转换由以下公式定义：

<SrcSubRect.left = SubRect.left - DstRect.left + SrcRect.left;
SrcSubRect.right = SubRect.right - DstRect.left + SrcRect.left;
SrcSubRect.top = SubRect.top - DstRect.top + SrcRect.top;
SrcSubRect.bottom = SubRect.bottom - DstRect.top + SrcRect.top;