D3DKMDT_GDISURFACETYPE列舉（d3dkmdt.h）

發行項
02/06/2025

D3DKMDT_GDISURFACETYPE列舉表示桌面視窗管理員（DWM）用於重新導向的可鎖定介面類型。

語法

typedef enum _D3DKMDT_GDISURFACETYPE {
  D3DKMDT_GDISURFACE_INVALID,
  D3DKMDT_GDISURFACE_TEXTURE,
  D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE,
  D3DKMDT_GDISURFACE_STAGING,
  D3DKMDT_GDISURFACE_LOOKUPTABLE,
  D3DKMDT_GDISURFACE_EXISTINGSYSMEM,
  D3DKMDT_GDISURFACE_TEXTURE_CPUVISIBLE,
  D3DKMDT_GDISURFACE_TEXTURE_CROSSADAPTER,
  D3DKMDT_GDISURFACE_TEXTURE_CPUVISIBLE_CROSSADAPTER
} D3DKMDT_GDISURFACETYPE;

常數


`D3DKMDT_GDISURFACE_INVALID` 驅動程式不應該看到此值。
`D3DKMDT_GDISURFACE_TEXTURE` 指出介面具有下列屬性：它有一層紋理。 CPU 看不到它，而視訊記憶體管理員會將其建立為共用表面。它會由使用者模式驅動程序開啟，並在 DWM 組合期間當做紋理使用。使用者模式驅動程式會使用它作為 DirectX 轉譯的轉譯目標。它做為 GDI 硬體加速作業中的來源或目的地介面。
`D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE` 指出介面具有下列屬性： CPU 可以看到它，而且會由CPU廣泛使用。配置必須是線性格式，且位於快取一致的 GPU 光圈區段中。它會作為 GDI 硬體加速作業中的來源介面。它做為 bitblt （僅限複製） GDI 作業中的目的地介面。其音調必須由顯示迷你埠驅動程式傳回。其間距值和表面地址必須對齊 DXGK_PRESENTATIONCAPS 結構 AlignmentShift 成員的值（也就是 DXGK_DRIVERCAPS->PresentationCaps.AlignmentShift）。
`D3DKMDT_GDISURFACE_STAGING` 指出介面具有下列屬性： CPU 看不到它。它做為 GDI 硬體加速作業中的來源或目的地介面。它用來做為 GDI 位blt（僅限複製）作業中的來源或目的地介面。
`D3DKMDT_GDISURFACE_LOOKUPTABLE` 指出介面具有下列屬性： CPU 看不到它。它只會在處理由 clearTypeBlend 和 OpCode所指定的命令處理期間使用。DXGK_RENDERKM_COMMAND 結構的DXGK_GDIOP_BITBLT（僅限複製）成員。格式是由 D3DDDIFORMAT 列舉的D3DDDIFMT_A8值所定義。伽瑪查閱配置會建立一次，而且在初始化之後永遠不會變更。配置會以D3DDDIFMT_A8格式初始化，方法是從D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE介面發出 DXGK_RENDERKM_COMMAND->Opcode.DXGK_GDIOP_BITBLT 命令。
`D3DKMDT_GDISURFACE_EXISTINGSYSMEM` 指出介面具有下列屬性： CPU 可以看到它。配置必須是線性格式，且位於快取一致的 GPU 光圈區段中。其間距值和表面地址必須對齊 DXGK_PRESENTATIONCAPS 結構 AlignmentShift 成員的值（也就是 DXGK_DRIVERCAPS->PresentationCaps.AlignmentShift）。介面位址會傳遞至驅動程式。這個值會以與 D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE 值相同的方式使用。
`D3DKMDT_GDISURFACE_TEXTURE_CPUVISIBLE` 保留供系統使用。請勿在驅動程式中使用此值。從 Windows 8 開始支援。
`D3DKMDT_GDISURFACE_TEXTURE_CROSSADAPTER` 指出介面具有下列屬性： CPU 看不到它，而視訊記憶體管理員會將其建立為共用的交叉配接器介面。其音調必須由投D3DKMDT_GDISURFACEDATA 結構成員中的顯示迷你埠驅動程序傳回。音調和高度必須具有交叉配接器資源所需的對齊方式。您可以使用 D3DKMT_CROSS_ADAPTER_RESOURCE_PITCH_ALIGNMENT 和 D3DKMT_CROSS_ADAPTER_RESOURCE_HEIGHT_ALIGNMENT 常數來驗證驅動程式傳回交叉配接器資源的正確音調和高度。這些常數定義於 D3dukmdt.h。從 Windows 8.1 開始支援。
`D3DKMDT_GDISURFACE_TEXTURE_CPUVISIBLE_CROSSADAPTER` 保留供系統使用。請勿在驅動程式中使用此值。從 Windows 8.1 開始支援。