D3DHAL_DP2ADDDIRTYRECT結構（d3dhal.h）

發行項
02/06/2025

僅限 DirectX 8.1 和更新版本。

D3DHAL_DP2ADDDIRTYRECT用來指定系統記憶體中已抹除 2D 資源的一部分--2D 紋理或立方體紋理。因此，這個 2D 紋理必須先重載到視訊記憶體中，才能使用。

語法

typedef struct _D3DHAL_DP2ADDDIRTYRECT {
  DWORD dwSurface;
  RECTL rDirtyArea;
} D3DHAL_DP2ADDDIRTYRECT;

成員

dwSurface

指定 Managed 2D 資源的句柄，其中包含已抹去的 2D 紋理。

rDirtyArea

指定標示為已抹去的 2D 紋理。這是 RECTL 結構。

言論

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