Bagikan melalui

Metode IDirect3DTexture9::AddDirtyRect (d3d9helper.h)

  • Artikel

Menambahkan wilayah kotor ke sumber daya tekstur.

Sintaks

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

Parameter

[in] pDirtyRect

Jenis: const RECT*

Pointer ke struktur RECT , menentukan wilayah kotor yang akan ditambahkan. Menentukan NULL memperluas wilayah kotor untuk menutupi seluruh tekstur.

Nilai kembali

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan D3D_OK. Jika metode gagal, nilai yang dikembalikan dapat D3DERR_INVALIDCALL.

Keterangan

Untuk alasan performa, wilayah kotor hanya dicatat untuk tingkat nol tekstur. Untuk sublevel, diasumsikan bahwa persegi panjang atau kotak yang sesuai (diskalakan) juga kotor. Wilayah kotor secara otomatis direkam ketika IDirect3DTexture9::LockRect dipanggil tanpa D3DLOCK_NO_DIRTY_UPDATE atau D3DLOCK_READONLY. Permukaan tujuan IDirect3DDevice9::UpdateSurface juga ditandai kotor secara otomatis.

Menggunakan D3DLOCK_NO_DIRTY_UPDATE dan secara eksplisit menentukan wilayah kotor dapat digunakan untuk meningkatkan efisiensi IDirect3DDevice9::UpdateTexture. Dengan menggunakan metode ini, aplikasi dapat mengoptimalkan subset sumber daya apa yang disalin dengan menentukan wilayah kotor pada sumber daya. Namun, wilayah kotor dapat diperluas untuk mengoptimalkan penyelarasan.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header d3d9helper.h (termasuk D3D9.h)
Pustaka D3D9.lib

Lihat juga

IDirect3DTexture9