estrutura D3DHAL_DP2ADDDIRTYBOX (d3dhal.h)

Artigo
02/23/2024

Somente o DirectX 8.1 e versões posteriores.

D3DHAL_DP2ADDDIRTYBOX é usado para especificar que uma parte de um recurso 3D, uma textura de volume, foi suja na memória do sistema. Portanto, esse volume deve ser recarregado na memória de vídeo antes de ser usado.

Sintaxe

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

Membros

dwSurface

Especifica o identificador para o recurso 3D gerenciado que contém uma textura de volume suja.

DirtyBox

Especifica a textura do volume que foi marcada como suja. Essa é uma estrutura D3DBOX, que é descrita na documentação do SDK do Microsoft Windows.

Comentários

D3DHAL_DP2ADDDIRTYBOX, juntamente com o token DP2OP_ADDDIRTYBOX, é usado apenas para recursos gerenciados pelo driver. D3DHAL_DP2ADDDIRTYBOX nunca é enviado, a menos que o driver indique que ele gerencia recursos. Para indicar que ele gerencia recursos, o driver deve definir o bit DDCAPS2_CANMANAGERESOURCE, além do bit DDCAPS2_CANMANAGETEXTURE, no membro dwCaps2 de uma estrutura DDCORECAPS. O driver especifica essa estrutura DDCORECAPS no membro ddCaps de uma estrutura DD_HALINFO quando a função DrvGetDirectDrawInfo do driver é chamada para inicializar o componente DirectDraw do driver.