Metode IDirect3DVolume9::LockBox (d3d9helper.h)

Mengunci kotak pada sumber daya volume.

Sintaks

HRESULT LockBox(
  [out] D3DLOCKED_BOX *pLockedVolume,
  [in]  const D3DBOX  *pBox,
  [in]  DWORD         Flags
);

Parameter

[out] pLockedVolume

Jenis: D3DLOCKED_BOX*

Penunjuk ke struktur D3DLOCKED_BOX , yang menjelaskan wilayah terkunci.

[in] pBox

Jenis: const D3DBOX*

Penunjuk ke kotak untuk dikunci. Ditentukan oleh penunjuk ke struktur D3DBOX . Menentukan NULL untuk parameter ini mengunci seluruh volume.

[in] Flags

Jenis: DWORD

Kombinasi bendera penguncian nol atau lebih yang menjelaskan jenis kunci yang akan dilakukan. Untuk metode ini, bendera yang valid adalah:

• D3DLOCK_DISCARD
• D3DLOCK_NO_DIRTY_UPDATE
• D3DLOCK_NOSYSLOCK
• D3DLOCK_READONLY

Untuk deskripsi bendera, lihat D3DLOCK.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Untuk alasan performa, wilayah kotor hanya dicatat untuk tingkat nol tekstur. Wilayah kotor secara otomatis direkam ketika IDirect3DVolume9::LockBox dipanggil tanpa D3DLOCK_NO_DIRTY_UPDATE atau D3DLOCK_READONLY. Lihat IDirect3DDevice9::UpdateTexture untuk informasi selengkapnya.

Persyaratan

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

Lihat juga

IDirect3DVolume9

IDirect3DVolume9::UnlockBox