Fungsi D3DXCreateVolumeTexture
Membuat tekstur volume kosong, menyesuaikan parameter panggilan sesuai kebutuhan.
Sintaks
HRESULT D3DXCreateVolumeTexture(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ UINT Width,
_In_ UINT Height,
_In_ UINT Depth,
_In_ UINT MipLevels,
_In_ DWORD Usage,
_In_ D3DFORMAT Format,
_In_ D3DPOOL Pool,
_Out_ LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);
Parameter
-
pDevice [in]
-
Jenis: LPDIRECT3DDEVICE9
Arahkan ke antarmuka IDirect3DDevice9 , yang mewakili perangkat yang akan dikaitkan dengan tekstur volume.
-
Lebar [in]
-
Jenis: UINT
Lebar dalam piksel. Nilai ini harus bukan nol. Dimensi maksimum yang didukung driver (untuk lebar, tinggi, dan kedalaman) dapat ditemukan di MaxVolumeExtent di D3DCAPS9.
-
Tinggi [in]
-
Jenis: UINT
Tinggi dalam piksel. Nilai ini harus bukan nol. Dimensi maksimum yang didukung driver (untuk lebar, tinggi, dan kedalaman) dapat ditemukan di MaxVolumeExtent di D3DCAPS9.
-
Kedalaman [in]
-
Jenis: UINT
Kedalaman dalam piksel. Nilai ini harus bukan nol. Dimensi maksimum yang didukung driver (untuk lebar, tinggi, dan kedalaman) dapat ditemukan di MaxVolumeExtent di D3DCAPS9.
-
MipLevels [in]
-
Jenis: UINT
Jumlah tingkat mip yang diminta. Jika nilai ini nol atau D3DX_DEFAULT, rantai mipmap lengkap akan dibuat.
-
Penggunaan [in]
-
Jenis: DWORD
0 atau D3DUSAGE_DYNAMIC. Untuk informasi selengkapnya tentang menggunakan tekstur dinamis, lihat Menggunakan Tekstur Dinamis.
-
Format [in]
-
Jenis: D3DFORMAT
Anggota jenis enumerasi D3DFORMAT , menjelaskan format piksel yang diminta untuk tekstur volume. Tekstur volume yang dikembalikan mungkin memiliki format yang berbeda dari yang ditentukan oleh Format. Aplikasi harus memeriksa format tekstur volume yang dikembalikan.
-
Pool [in]
-
Jenis: D3DPOOL
Anggota jenis enumerasi D3DPOOL , yang menjelaskan kelas memori tempat tekstur volume harus ditempatkan.
-
ppVolumeTexture [out]
-
Jenis: LPDIRECT3DVOLUMETEXTURE9*
Alamat penunjuk ke antarmuka IDirect3DVolumeTexture9 , mewakili objek tekstur volume yang dibuat.
Menampilkan nilai
Jenis: HRESULT
Jika fungsi berhasil, nilai yang dikembalikan adalah D3D_OK. Jika fungsi gagal, nilai yang dikembalikan dapat berupa salah satu hal berikut: D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DERR_INVALIDCALL, E_OUTOFMEMORY .
Keterangan
Secara internal, D3DXCreateVolumeTexture menggunakan D3DXCheckVolumeTextureRequirements untuk menyesuaikan parameter panggilan. Oleh karena itu, panggilan ke D3DXCreateVolumeTexture akan sering berhasil di mana panggilan ke CreateVolumeTexture akan gagal.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header |
|
| Pustaka |
|
Lihat juga