DXGK_GDIARG_BITBLT結構 (d3dkmddi.h)

發行項
02/23/2024

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 位值，指定 GDI 點陣運算 (ROP) ，由 DXGK_GDIROP_BITBLT 列舉的常數值所定義。

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結構 (的AlignmentShift 成員，保證在位區塊傳輸中對齊DXGK_DRIVERCAPS。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;