Share via

Fungsi D3DXCheckTextureRequirements

  • Artikel

Memeriksa parameter pembuatan tekstur.

Sintaks

HRESULT D3DXCheckTextureRequirements(
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Inout_ UINT              *pWidth,
  _Inout_ UINT              *pHeight,
  _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.

pWidth [masuk, keluar]

Jenis: UINT*

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

pHeight [masuk, keluar]

Jenis: UINT*

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

pNumMipLevels [masuk, keluar]

Jenis: UINT*

Penunjuk 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_INVALIDCALL, D3DERR_NOTAVAILABLE.

Keterangan

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

Fungsi ini menggunakan heuristik berikut saat membandingkan persyaratan yang diminta dengan format yang tersedia:

  • Jangan pilih format yang memiliki lebih sedikit saluran.
  • Hindari format FOURCC Dan 24-bit kecuali diminta secara eksplisit.
  • Cobalah untuk tidak menambahkan saluran baru.
  • Cobalah untuk tidak mengubah jumlah bit per saluran.
  • Cobalah untuk menghindari konversi antara jenis format. Misalnya, hindari mengonversi format ARGB ke format kedalaman.

Persyaratan

Persyaratan Nilai
Header
D3dx9tex.h
Pustaka
D3dx9.lib

Lihat juga

Fungsi Tekstur di D3DX 9