IDirect3DVolumeTexture9：：AddDirtyBox 方法 (d3d9.h)

將已變更的區域新增至磁碟區紋理資源。

語法

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

[in] pDirtyBox

類型： const D3DBOX*

D3DBOX 結構的指標，指定要加入的已變更區域。指定 NULL 會展開已變更的區域，以涵蓋整個磁碟區紋理。

類型： HRESULT

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

基於效能考慮，只會記錄紋理層級零的已變更區域。針對子層級，假設對應的 (縮放) 方塊也會變更。呼叫 LockBox 而不需D3DLOCK_NO_DIRTY_UPDATE 或 D3DLOCK_READONLY時，系統會自動記錄已變更的區域。

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