共用方式為


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_UPDATED3DLOCK_READONLYIDirect3DDevice9::UpdateSurface 的目的地介面也會自動標示為已變更。

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

規格需求

需求
目標平台 Windows
標頭 d3d9helper.h (包含 D3D9.h)
程式庫 D3D9.lib

另請參閱

IDirect3DTexture9