IDirect3DTexture9::AddDirtyRect-Methode (d3d9helper.h)

Fügt einer Texturressource einen modifiziert Bereich hinzu.

Syntax

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

Parameter

[in] pDirtyRect

Typ: const RECT*

Zeiger auf eine RECT-Struktur, der den hinzuzufügenden modifiziert Bereich angibt. Die Angabe von NULL erweitert den modifiziert Bereich, um die gesamte Textur 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 D3DERR_INVALIDCALL werden.

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 IDirect3DTexture9::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.

Anforderungen

Weitere Informationen

IDirect3DTexture9