Share via

Fungsi D3DXCreateVolumeTexture

  • Artikel

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
D3dx9tex.h
Pustaka
D3dx9.lib

Lihat juga

Fungsi Tekstur di D3DX 9