Fungsi D3DXCheckCubeTextureRequirements

Artikel
06/13/2023

Memeriksa parameter pembuatan kubus-tekstur.

Sintaks

HRESULT D3DXCheckCubeTextureRequirements(
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Inout_ UINT              *pSize,
  _Inout_ UINT              *pNumMipLevels,
  _In_    DWORD             Usage,
  _Inout_ D3DFORMAT         *pFormat,
  _In_    D3DPOOL           Pool
);

Parameter

pDevice [in]

Jenis: LPDIRECT3DDEVICE9

Penunjuk ke antarmuka IDirect3DDevice9 , mewakili perangkat yang akan dikaitkan dengan tekstur kubus.

pSize [masuk, keluar]

Jenis: UINT*

Penunjuk ke lebar dan tinggi yang diminta dalam piksel, atau NULL. Mengembalikan ukuran yang dikoreksi.

pNumMipLevels [masuk, keluar]

Jenis: UINT*

Arahkan ke jumlah tingkat mipmap yang diminta, atau NULL. Mengembalikan jumlah tingkat mipmap yang dikoreksi.

Penggunaan [in]

Jenis: DWORD

0 atau D3DUSAGE_RENDERTARGET. Mengatur bendera ini ke D3DUSAGE_RENDERTARGET menunjukkan bahwa permukaan akan digunakan sebagai target render. Sumber daya kemudian dapat diteruskan ke parameter pNewRenderTarget dari metode SetRenderTarget . Jika D3DUSAGE_RENDERTARGET ditentukan, aplikasi harus memeriksa apakah perangkat mendukung operasi ini dengan memanggil CheckDeviceFormat.

pFormat [masuk, keluar]

Jenis: D3DFORMAT*

Penunjuk ke anggota jenis enumerasi D3DFORMAT . Menentukan format piksel yang diinginkan, atau NULL. Mengembalikan format yang dikoreksi.

Pool [in]

Jenis: D3DPOOL

Anggota jenis enumerasi D3DPOOL , yang menjelaskan kelas memori tempat tekstur harus ditempatkan.

Menampilkan nilai

Jenis: HRESULT

Jika fungsi berhasil, nilai yang dikembalikan adalah D3D_OK. Jika fungsi gagal, nilai yang dikembalikan bisa menjadi salah satu dari yang berikut: D3DERR_NOTAVAILABLE, D3DERR_INVALIDCALL.

Keterangan

Jika parameter untuk fungsi ini tidak valid, fungsi ini mengembalikan parameter yang dikoreksi.

Tekstur kubus berbeda dari permukaan lain karena mereka adalah koleksi permukaan. Untuk memanggil SetRenderTarget dengan tekstur kubus, Anda harus memilih wajah individual menggunakan GetCubeMapSurface dan meneruskan permukaan yang dihasilkan ke SetRenderTarget.

Persyaratan

Persyaratan	Nilai
Header	D3dx9tex.h
Pustaka	D3dx9.lib

Lihat juga

Fungsi Tekstur di D3DX 9

Share via