IDirect3DCubeTexture9::AddDirtyRect-Methode (d3d9helper.h)

Artikel
08/23/2023

Fügt einer Cubetexturressource einen modifiziert Bereich hinzu.

Syntax

HRESULT AddDirtyRect(
  [in] D3DCUBEMAP_FACES FaceType,
  [in] const RECT       *pDirtyRect
);

Parameter

[in] FaceType

Typ: D3DCUBEMAP_FACES

Member des D3DCUBEMAP_FACES aufgezählten Typs, der die Würfelzuordnungssicht identifiziert.

[in] pDirtyRect

Typ: const RECT*

Zeiger auf eine RECT-Struktur, der den modifiziert Bereich angibt. Die Angabe von NULL erweitert den modifiziert Bereich, um die gesamte Würfeltextur abzudecken.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert sein: D3DERR_INVALIDCALL.

Hinweise

Aus Leistungsgründen werden modifiziert Regionen nur für ebene null einer Textur aufgezeichnet. Bei Unterebenen wird davon ausgegangen, dass das entsprechende (skalierte) Rechteck oder Feld ebenfalls modifiziert ist. Fehlerhafte Regionen werden automatisch aufgezeichnet, wenn IDirect3DCubeTexture9::LockRect ohne D3DLOCK_NO_DIRTY_UPDATE oder D3DLOCK_READONLY aufgerufen wird. Die Zieloberfläche von IDirect3DDevice9::UpdateSurface wird ebenfalls automatisch modifiziert markiert.

Die Verwendung von D3DLOCK_NO_DIRTY_UPDATE und explizites Angeben modifiziert Regionen kann verwendet werden, um die Effizienz von IDirect3DDevice9::UpdateTexture zu erhöhen. Mit dieser Methode können Anwendungen optimieren, welche Teilmenge einer Ressource kopiert wird, indem sie modifiziert Regionen für die Ressource angeben. Die modifiziert Regionen können jedoch erweitert werden, um die Ausrichtung zu optimieren.