D3DHAL_DP2ADDDIRTYBOX結構（d3dhal.h）

2025-02-06

僅限 DirectX 8.1 和更新版本。

D3DHAL_DP2ADDDIRTYBOX用來指定系統記憶體中已抹除 3D 資源的一部分--磁碟區紋理。因此，此磁碟區必須先重載到視訊記憶體中，才能使用。

語法

typedef struct _D3DHAL_DP2ADDDIRTYBOX {
  DWORD  dwSurface;
  D3DBOX DirtyBox;
} D3DHAL_DP2ADDDIRTYBOX;

成員

dwSurface

指定 Managed 3D 資源的句柄，其中包含已變更的磁碟區紋理。

DirtyBox

指定標示為已抹去的磁碟區紋理。這是 D3DBOX 結構，如Microsoft Windows SDK 檔所述。

言論

D3DHAL_DP2ADDDIRTYBOX，以及DP2OP_ADDDIRTYBOX令牌，僅用於驅動程式受控資源。除非驅動程式指出其管理資源，否則不會傳送D3DHAL_DP2ADDDIRTYBOX。若要指出其管理資源，驅動程式除了DDCAPS2_CANMANAGETEXTURE位之外，還必須在 DDCORECAPS 結構的 dwCaps2 成員中設定DDCAPS2_CANMANAGERESOURCE位。當呼叫驅動程式的 DrvGetDirectDrawInfo 函式時，驅動程式會在呼叫驅動程式 DrvGetDirectDrawInfo 函式時，在 ddCapsDD_HALINFO 成員中指定 DDCORECAPS 結構。