D3DHAL_DP2ADDDIRTYRECT Struktur (d3dhal.h)

2025-02-06

Nur DirectX 8.1 und höhere Versionen.

D3DHAL_DP2ADDDIRTYRECT wird verwendet, um anzugeben, dass ein Teil einer 2D-Ressource – eine 2D-Textur oder Würfeltextur – im Systemspeicher schmutzig wurde. Daher muss diese 2D-Textur vor der Verwendung in den Videospeicher neu geladen werden.

Syntax

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

Angehörige

dwSurface

Gibt das Handle für die verwaltete 2D-Ressource an, die eine schmutzige 2D-Textur enthält.

rDirtyArea

Gibt die 2D-Textur an, die als schmutzig markiert wurde. Dies ist eine RECTL- Struktur.

Bemerkungen

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