IDirect3DVolumeTexture9::AddDirtyBox-Methode (d3d9helper.h)

Fügt einer Volumetexturressource eine modifiziert Region hinzu.

Syntax

HRESULT AddDirtyBox(
  [in] const D3DBOX *pDirtyBox
);

Parameter

[in] pDirtyBox

Typ: const D3DBOX*

Zeiger auf eine D3DBOX-Struktur, wobei der hinzuzufügende modifiziert Region angegeben wird. Wenn Sie NULL angeben, wird der modifiziert Bereich erweitert, um die gesamte Volumetextur 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. Für Unterebenen wird davon ausgegangen, dass das entsprechende (skalierte) Feld ebenfalls modifiziert ist. Fehlerhafte Regionen werden automatisch aufgezeichnet, wenn LockBox ohne D3DLOCK_NO_DIRTY_UPDATE oder D3DLOCK_READONLY aufgerufen wird.

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

Anforderungen

Zielplattform	Windows
Kopfzeile	d3d9helper.h (einschließlich D3D9.h)
Bibliothek	D3D9.lib

Weitere Informationen

IDirect3DVolumeTexture9