D3DHAL_DP2ADDDIRTYBOX 構造体 (d3dhal.h)

[アーティクル]
08/07/2023

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

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

構文

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

メンバー

dwSurface

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

DirtyBox

未加工としてマークされたボリュームテクスチャを指定します。これは D3DBOX 構造体であり、Microsoft Windows SDKドキュメントで説明されています。

注釈

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