DXGK_GDIARG_STRETCHBLT结构（d3dkmddi.h）
DXGK_GDIARG_STRETCHBLT 结构描述了 GDI 硬件加速拉伸位块传输（bitblt）作的特征。
语法
typedef struct _DXGK_GDIARG_STRETCHBLT {
[in] RECT SrcRect;
[in] RECT DstRect;
[in] UINT DstAllocationIndex;
[in] UINT SrcAllocationIndex;
UINT NumSubRects;
[in] RECT *pSubRects;
union {
struct {
UINT Mode : 16;
UINT MirrorX : 1;
UINT MirrorY : 1;
};
[in] UINT Flags;
};
[in] UINT SrcPitch;
} DXGK_GDIARG_STRETCHBLT;
成员
[in] SrcRect
RECT 结构，用于定义要复制的矩形区域。 此矩形在源图面的坐标系中指定，由两个点定义：左上角和右下角。 定义矩形的两个点始终是有序的。
源矩形永远不会超过源图面的边界，因此它永远不会悬停源图面。
此矩形映射到由 DstRect定义的目标矩形。
有关详细信息，请参阅“备注”部分。
[in] DstRect
RECT 结构，用于定义要修改的矩形区域。 此矩形在目标图面的坐标系中指定，由两个点定义：左上角和右下角。 矩形右下角为独占;也就是说，它的下边缘和右边缘不是位块传输的一部分。 定义矩形的两个点始终是有序的。
DstRect 定义的目标矩形 可以超出目标图面的边界，但子矩形不能。 此外，保证所有子矩形都适合目标图面。 子矩形可由小于目标矩形的边界矩形进一步约束。
有关详细信息，请参阅“备注”部分。
[in] DstAllocationIndex
分配列表中的元素的索引，指定由 DstRect 目标矩形引用的分配。
[in] SrcAllocationIndex
分配列表中的元素的索引，指定 SrcRect 源矩形引用的分配。
NumSubRects
目标图面空间中由 DstRect 目标矩形绑定的子矩形数。
[in] pSubRects
指向目标图面空间中由 DstRect 目标矩形绑定的子矩形的指针。
[in] Mode
根据是否设置了以下 在 Wingdi.h 中定义的值，指定源像素如何组合以生成输出像素：
| 价值 | 意义 |
|---|---|
| BLACKONWHITE | 在收缩位块传输中，像素应与布尔 AND作组合在一起。 在拉伸位块传输中，应复制像素。 |
| WHITEONBLACK | 在收缩位块传输中，像素应与布尔 OR作结合使用。 在拉伸位块传输中，应复制像素。 |
仅当驱动程序在 DXGK_PRESENTATIONCAPS 结构中设置 SupportMonoStretchBltModes 成员时，才会处理此类作。
[in] MirrorX
指定是否在 xdirection 中的镜像模式下执行拉伸位块传输。 仅当 MirrorX 的值为非零且驱动程序在 DXGK_PRESENTATIONCAPS 结构中设置 SupportMirrorStretchBlt 成员时，才会处理这种类型的作。
[in] MirrorY
指定是否在 y 方向的镜像模式下执行拉伸位块传输。 仅当 MirrorY 的值为非零且驱动程序在 DXGK_PRESENTATIONCAPS 结构中设置了 SupportMirrorStretchBlt 成员时，才会处理这种类型的作。
[in] Flags
可用于调试驱动程序代码的可选 UINT 值。
[in] SrcPitch
源图面的间距（以字节为单位）。
言论
x 和 y 拉伸比率分别作为 DstRect 的 x 和 y 大小的比率计算，SrcRect 成员。
Wingdi.h 中定义的 HALFTONE 模式和STRETCH_HALFTONE模式永远不会在 模式 成员中设置。 可以在 DXGK_GDIARG_ALPHABLEND 和 DXGK_GDIARG_TRANSPARENTBLT 结构中设置 COLORONCOLOR 模式。
将子矩形转换为源图面空间时，保证结果位于源图面中。 以下公式定义了子矩形的目标图面中坐标到源图面中的坐标的转换，其中
- （Xd，Yd）是子矩形内的一个点
- （Xs，Ys） 是源矩形内的一个点
float Ws = SrcRect.right - SrcRect.left;
float Wd = DstRect.right - DstRect.left;
int Xs = round((Xd - DstRect.left + 0.5) * Ws/Wd + SrcRect.left - 0.5)
OR
int Xs = truncate((Xd - DstRect.left + 0.5) * Ws/Wd + SrcRect.left)
float Hs = SrcRect.bottom - SrcRect.top;
float Hd = DstRect.bottom - DstRect.top;
int Ys = round((Yd - DstRect.top + 0.5) * Hs/Hd + SrcRect.top - 0.5)
OR
int Ys = truncate((Yd - DstRect.top + 0.5) * Hs/Hd + SrcRect.top)
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 7 |
| 标头 | d3dkmddi.h （包括 D3dkmddi.h） |