IDirect3DTexture9：：AddDirtyRect 方法 (d3d9helper.h)

將中途區域新增至紋理資源。

語法

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

[in] pDirtyRect

類型： const RECT*

RECT 結構的指標，指定要加入的中途區域。指定 NULL 會展開中途區域以涵蓋整個紋理。

類型： HRESULT

如果方法成功，傳回值會D3D_OK。如果方法失敗，則可以D3DERR_INVALIDCALL傳回值。

基於效能考慮，已變更的區域只會針對紋理的層級零進行記錄。針對子層級，假設對應的 (縮放) 矩形或方塊也會變更。呼叫 IDirect3DTexture9：：LockRect 時，系統會自動記錄變更區域，而不需D3DLOCK_NO_DIRTY_UPDATE 或 D3DLOCK_READONLY。 IDirect3DDevice9：：UpdateSurface 的目的地介面也會自動標示為已變更。

使用 D3DLOCK_NO_DIRTY_UPDATE 並明確指定中途區域，可用來提升 IDirect3DDevice9：：UpdateTexture 的效率。使用此方法，應用程式可以藉由在資源上指定中途區域，將資源子集的複製項目優化。不過，可能會擴充中途區域以優化對齊方式。