IDirect3DVolumeTexture9：：AddDirtyBox 方法 (d3d9helper.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的效率。使用此方法，應用程式可以藉由在資源上指定中途方塊，將資源子集的複製專案優化。不過，可能會擴充中途區域以優化對齊方式。