D3DLOCK

Kombinasi nol atau beberapa opsi penguncian yang menjelaskan jenis kunci yang akan dilakukan.

#define Deskripsi
D3DLOCK_DISCARD Aplikasi membuang semua memori dalam wilayah terkunci. Untuk buffer vertex dan indeks, seluruh buffer akan dibuang. Opsi ini hanya valid ketika sumber daya dibuat dengan penggunaan dinamis (lihat D3DUSAGE).
D3DLOCK_DONOTWAIT Memungkinkan aplikasi untuk mendapatkan kembali siklus CPU jika driver tidak dapat segera mengunci permukaan. Jika bendera ini diatur dan driver tidak dapat segera mengunci permukaan, panggilan kunci akan kembali D3DERR_WASSTILLDRAWING. Bendera ini hanya dapat digunakan saat mengunci permukaan yang dibuat menggunakan CreateOffscreenPlainSurface, CreateRenderTarget, atau CreateDepthStencilSurface. Bendera ini juga dapat digunakan dengan buffer belakang.
D3DLOCK_NO_DIRTY_UPDATE Secara default, kunci pada sumber daya menambahkan wilayah kotor ke sumber daya tersebut. Opsi ini mencegah perubahan apa pun pada status kotor sumber daya. Aplikasi harus menggunakan opsi ini ketika mereka memiliki informasi tambahan tentang kumpulan wilayah yang diubah selama operasi penguncian.
D3DLOCK_NOOVERWRITE Menunjukkan bahwa memori yang dirujuk dalam panggilan gambar sejak kunci terakhir tanpa bendera ini tidak akan dimodifikasi selama kunci. Ini dapat mengaktifkan pengoptimalan saat aplikasi menambahkan data ke sumber daya. Menentukan bendera ini memungkinkan driver untuk segera kembali jika sumber daya sedang digunakan, jika tidak, driver harus selesai menggunakan sumber daya sebelum kembali dari penguncian.
D3DLOCK_NOSYSLOCK Perilaku default kunci memori video adalah memesan bagian penting di seluruh sistem, menjamin bahwa tidak ada perubahan mode tampilan yang akan terjadi selama durasi kunci. Opsi ini menyebabkan bagian penting di seluruh sistem tidak ditahan selama durasi kunci.
Operasi penguncian memakan waktu, tetapi dapat memungkinkan sistem untuk melakukan tugas lain, seperti memindahkan kursor mouse. Opsi ini berguna untuk kunci durasi panjang, seperti kunci buffer belakang untuk penyajian perangkat lunak yang sebaliknya akan berdampak buruk pada responsivitas sistem.
D3DLOCK_READONLY Aplikasi tidak akan menulis ke buffer. Ini memungkinkan sumber daya yang disimpan dalam format non-asli untuk menyimpan langkah rekompresi saat membuka kunci.

 

Informasi Konstanta

Persyaratan Nilai
Header d3d9types.h
Sistem operasi minimum Windows 98

 

Konstanta Direct3D

LockRect

Lock

LockRect

LockRect

Lock

LockBox

LockBox

LockIndexBuffer

LockVertexBuffer

LockVertexBuffer

LockAttributeBuffer

LockAttributeBuffer

LockIndexBuffer

LockVertexBuffer