Fungsi D3DXCheckTextureRequirements
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 |
|
| Pustaka |
|
Lihat juga