Metode IDirect3DTexture9::AddDirtyRect (d3d9helper.h)
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 |