D3DHAL_DP2ADDDIRTYRECT 構造体 (d3dhal.h)

[アーティクル]
02/23/2024

DirectX 8.1 以降のバージョンのみ。

D3DHAL_DP2ADDDIRTYRECTは、2D リソースの一部 (2D テクスチャまたはキューブテクスチャ) がシステムメモリに汚れたことを指定するために使用されます。そのため、この 2D テクスチャは、使用する前にビデオメモリに再読み込みする必要があります。

構文

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

メンバー

dwSurface

汚れた 2D テクスチャを含むマネージド 2D リソースへのハンドルを指定します。

rDirtyArea

ダーティとしてマークされた 2D テクスチャを指定します。これは RECTL 構造体です。

注釈

D3DHAL_DP2ADDDIRTYRECT、DP2OP_ADDDIRTYRECT トークンと共に、ドライバーマネージドリソースとサーフェスにのみ使用されます。ドライバーがリソースを管理することを示さない限り、D3DHAL_DP2ADDDIRTYRECTは送信されません。リソースを管理することを示すために、ドライバーは、 DDCORECAPS 構造体の dwCaps2 メンバーで、DDCAPS2_CANMANAGETEXTURE ビットに加えて、DDCAPS2_CANMANAGERESOURCE ビットを設定する必要があります。ドライバーは、ドライバーの DirectDraw コンポーネントを初期化するためにドライバーの DrvGetDirectDrawInfo 関数が呼び出されたときに、DD_HALINFO構造体の ddCaps メンバーにこの DDCORECAPS 構造体を指定します。