Metode IDirect3DVolumeTexture9::LockBox (d3d9helper.h)

  • Artikel

Mengunci kotak pada sumber daya tekstur volume.

Sintaks

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

Parameter

[in] Level

Jenis: UINT

Menentukan tingkat sumber daya tekstur volume untuk dikunci.

[out] pLockedVolume

Jenis: D3DLOCKED_BOX*

Penunjuk ke struktur D3DLOCKED_BOX , yang menjelaskan wilayah terkunci.

[in] pBox

Jenis: const D3DBOX*

Arahkan ke volume untuk dikunci. Parameter ini ditentukan oleh penunjuk ke struktur D3DBOX . Menentukan NULL untuk parameter ini mengunci seluruh tingkat 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 saat LockBox dipanggil tanpa D3DLOCK_NO_DIRTY_UPDATE atau D3DLOCK_READONLY. Untuk informasi selengkapnya, lihat UpdateTexture.

Persyaratan

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

Lihat juga

IDirect3DVolumeTexture9

UnlockBox