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
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | d3d9helper.h (include D3D9.h) |
| Bibliothek | D3D9.lib |