D3DKMDT_SHADOWSURFACEDATA 結構 (d3dkmdt.h)

發行項
05/18/2024

D3DKMDT_SHADOWSURFACEDATA 結構描述可鎖定的陰影表面，其符合指定顯示模式的格式和解析度的主要表面。

語法

typedef struct _D3DKMDT_SHADOWSURFACEDATA {
  [in]  UINT         Width;
  [in]  UINT         Height;
  [in]  D3DDDIFORMAT Format;
  [out] UINT         Pitch;
} D3DKMDT_SHADOWSURFACEDATA;

成員

[in] Width

表面的寬度，以像素為單位。驅動程式會傳回寬度值。

[in] Height

表面的高度，以像素為單位。驅動程式會傳回高度值。

[in] Format

表示表面圖元格式的D3DDDIFORMAT型別值。驅動程式會傳回格式值。

[out] Pitch

介面的寬度，以位元組為單位。驅動程式必須傳回傾斜值，因為陰影表面是可鎖定的。

備註

D3DKMDT_SHADOWSURFACEDATA結構是由 Microsoft DirectX 圖形核心子系統在呼叫顯示迷你埠驅動程式的 DxgkDdiGetStandardAllocationDriverData 函式中傳遞，以產生可鎖定陰影表面的描述。 DirectX 圖形核心子系統會在呼叫顯示迷你埠驅動程式的 DxgkDdiCreateAllocation 函式中，使用描述來建立可鎖定的陰影表面。

CPU 會繪製到鎖定的陰影表面、解除鎖定陰影表面，然後透過陰影表面向相符的共用主要介面發出位區塊傳輸 (bitblt) 要求。也會發出位區塊傳輸要求，以將數據從共用的主要表面傳輸到陰影表面。

從陰影表面複製數據或將數據複製到陰影表面時，不需要色彩轉換、延展或壓縮作業，因為陰影和共用主要表面的來源和目的地格式和維度一律相符。