D3DHAL_DP2ADDDIRTYBOX Struktur (d3dhal.h)

Artikel
02/26/2024

Nur DirectX 8.1 und höhere Versionen.

D3DHAL_DP2ADDDIRTYBOX wird verwendet, um anzugeben, dass ein Teil einer 3D-Ressource - einer Volumetextur - im Systemspeicher verschmutzt wurde. Daher muss dieses Volume vor der Verwendung in den Videospeicher neu geladen werden.

Syntax

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

Member

dwSurface

Gibt das Handle für die verwaltete 3D-Ressource an, das eine uneckige Volumetextur enthält.

DirtyBox

Gibt die Volumetextur an, die als verschmutzt markiert wurde. Dies ist eine D3DBOX-Struktur, die in der Microsoft Windows SDK-Dokumentation beschrieben wird.

Hinweise

D3DHAL_DP2ADDDIRTYBOX wird zusammen mit dem DP2OP_ADDDIRTYBOX-Token nur für vom Treiber verwaltete Ressourcen verwendet. D3DHAL_DP2ADDDIRTYBOX wird nie gesendet, es sei denn, der Treiber gibt an, dass er Ressourcen verwaltet. Um anzugeben, dass Ressourcen verwaltet werden, muss der Treiber das DDCAPS2_CANMANAGERESOURCE Bit zusätzlich zum DDCAPS2_CANMANAGETEXTURE Bit im dwCaps2-Member einer DDCORECAPS-Struktur festlegen. Der Treiber gibt diese DDCORECAPS-Struktur im ddCaps-Member einer DD_HALINFO-Struktur an, wenn die DrvGetDirectDrawInfo-Funktion des Treibers aufgerufen wird, um die DirectDraw-Komponente des Treibers zu initialisieren.