структура D3DHAL_DP2ADDDIRTYBOX (d3dhal.h)

Статья
08/07/2023

Только DirectX 8.1 и более поздних версий.

D3DHAL_DP2ADDDIRTYBOX используется для указания того, что часть трехмерного ресурса — текстура тома — была грязна в системной памяти. Поэтому перед использованием этот том необходимо перезагрузить в видеопамяти.

Синтаксис

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

Члены

dwSurface

Указывает дескриптор управляемого трехмерного ресурса, который содержит текстуру тома с грязью.

DirtyBox

Указывает текстуру тома, которая была помечена как грязная. Это структура D3DBOX, описанная в документации по Microsoft Windows SDK.

D3DHAL_DP2ADDDIRTYBOX вместе с маркером DP2OP_ADDDIRTYBOX используется только для ресурсов, управляемых драйвером. D3DHAL_DP2ADDDIRTYBOX никогда не отправляется, если драйвер не укажет, что он управляет ресурсами. Чтобы указать, что он управляет ресурсами, драйвер должен задать бит DDCAPS2_CANMANAGERESOURCE в дополнение к биту DDCAPS2_CANMANAGETEXTURE в элементе dwCaps2 структуры DDCORECAPS. Драйвер указывает эту структуру DDCORECAPS в элементе ddCapsструктуры DD_HALINFO при вызове функции DrvGetDirectDrawInfo драйвера для инициализации компонента DirectDraw драйвера.