D3DHAL_DP2ADDDIRTYBOX 結構 (d3dhal.h)

發行項
02/23/2024

僅限 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函式來初始化驅動程式的 DirectDraw 元件時，驅動程式會在DD_HALINFO結構的 ddCaps 成員中指定這個 DDCORECAPS 結構。