Metode IDirect3DCubeTexture9::LockRect (d3d9.h)

Artikel
08/23/2023

Mengunci persegi panjang pada sumber daya tekstur kubus.

Sintaks

HRESULT LockRect(
  [in]  D3DCUBEMAP_FACES FaceType,
  [in]  UINT             Level,
  [out] D3DLOCKED_RECT   *pLockedRect,
  [in]  const RECT       *pRect,
  [in]  DWORD            Flags
);

Parameter

[in] FaceType

Jenis: D3DCUBEMAP_FACES

Anggota jenis D3DCUBEMAP_FACES yang dijumlahkan, mengidentifikasi wajah peta kubus.

[in] Level

Jenis: UINT

Menentukan tingkat tekstur kubus mipmapped.

[out] pLockedRect

Jenis: D3DLOCKED_RECT*

Penunjuk ke struktur D3DLOCKED_RECT , yang menjelaskan wilayah yang akan dikunci.

[in] pRect

Jenis: const RECT*

Penunjuk ke persegi panjang untuk dikunci. Ditentukan oleh penunjuk ke struktur RECT . Menentukan NULL untuk parameter ini memperluas wilayah kotor untuk mencakup seluruh tekstur kubus.

[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

Anda mungkin tidak menentukan subkor ketika menggunakan D3DLOCK_DISCARD. Untuk deskripsi bendera, lihat D3DLOCK.

Menampilkan nilai

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan adalah D3D_OK. D3DERR_INVALIDCALL dikembalikan jika satu atau beberapa argumen tidak valid.

Keterangan

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

Tekstur kubus yang dibuat dengan D3DPOOL_DEFAULT tidak dapat dikunci. Tekstur kubus yang dibuat dalam memori video dapat dikunci saat dibuat dengan USAGE_DYNAMIC.

Satu-satunya format yang dapat dikunci untuk tekstur stensil kedalaman adalah D3DFMT_D16_LOCKABLE.