Fungsi D3DXCreateTexture

Membuat tekstur kosong, menyesuaikan parameter panggilan sesuai kebutuhan.

Sintaks

HRESULT D3DXCreateTexture(
  _In_  LPDIRECT3DDEVICE9  pDevice,
  _In_  UINT               Width,
  _In_  UINT               Height,
  _In_  UINT               MipLevels,
  _In_  DWORD              Usage,
  _In_  D3DFORMAT          Format,
  _In_  D3DPOOL            Pool,
  _Out_ LPDIRECT3DTEXTURE9 *ppTexture
);

Parameter

pDevice [in]

Jenis: LPDIRECT3DDEVICE9

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

Lebar [in]

Jenis: UINT

Lebar dalam piksel. Jika nilai ini adalah 0, nilai 1 akan digunakan. Lihat Keterangan.

Tinggi [in]

Jenis: UINT

Tinggi dalam piksel. Jika nilai ini adalah 0, nilai 1 akan digunakan. Lihat Keterangan.

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, D3DUSAGE_RENDERTARGET, atau D3DUSAGE_DYNAMIC. Mengatur bendera ini ke D3DUSAGE_RENDERTARGET menunjukkan bahwa permukaan akan digunakan sebagai target render dengan memanggil metode SetRenderTarget . Jika D3DUSAGE_RENDERTARGET atau D3DUSAGE_DYNAMIC ditentukan, aplikasi harus memeriksa apakah perangkat mendukung operasi ini dengan memanggil CheckDeviceFormat. 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. Tekstur yang dikembalikan mungkin memiliki format yang berbeda dari yang ditentukan, jika perangkat tidak mendukung format yang diminta. Aplikasi harus memeriksa format tekstur yang dikembalikan untuk melihat apakah cocok dengan format yang diminta.

Pool [in]

Jenis: D3DPOOL

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

ppTexture [out]

Jenis: LPDIRECT3DTEXTURE9*

Alamat penunjuk ke antarmuka IDirect3DTexture9 , mewakili objek tekstur 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_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.

Keterangan

Secara internal, D3DXCreateTexture menggunakan D3DXCheckTextureRequirements untuk menyesuaikan parameter panggilan. Oleh karena itu, panggilan ke D3DXCreateTexture akan sering berhasil di mana panggilan ke CreateTexture akan gagal.

Jika Tinggi dan Lebar diatur ke D3DX_DEFAULT, nilai 256 digunakan untuk kedua parameter. Jika Tinggi atau Lebar diatur ke D3DX_DEFAULT Dan parameter lainnya diatur ke nilai numerik, tekstur akan persegi dengan tinggi dan lebar yang sama dengan nilai numerik.

Persyaratan

Persyaratan	Nilai
Header	D3dx9tex.h
Pustaka	D3dx9.lib

Lihat juga

Fungsi Tekstur di D3DX 9