Bagikan melalui


METODE ID3D10Device::CreateTexture3D (d3d10.h)

Buat tekstur 3D tunggal (lihat Texture3D).

Sintaks

HRESULT CreateTexture3D(
  [in]  const D3D10_TEXTURE3D_DESC   *pDesc,
  [in]  const D3D10_SUBRESOURCE_DATA *pInitialData,
  [out] ID3D10Texture3D              **ppTexture3D
);

Parameter

[in] pDesc

Jenis: const D3D10_TEXTURE3D_DESC*

Penunjuk ke deskripsi tekstur 3D (lihat D3D10_TEXTURE3D_DESC). Untuk membuat sumber daya tanpa jenis yang dapat ditafsirkan saat runtime ke dalam format yang berbeda dan kompatibel, tentukan format tanpa jenis dalam deskripsi tekstur. Untuk menghasilkan tingkat mipmap secara otomatis, atur jumlah tingkat mipmap ke 0.

[in] pInitialData

Jenis: const D3D10_SUBRESOURCE_DATA*

Penunjuk ke array deskripsi sub sumber daya (lihat D3D10_SUBRESOURCE_DATA); satu untuk setiap subsumber daya (diurutkan menurut indeks array tekstur, lalu ikat indeks, lalu tingkat mip). Aplikasi mungkin tidak menentukan NULL untuk pInitialData saat membuat sumber daya IMMUTABLE (lihat D3D10_USAGE). Jika sumber daya multisampled, pInitialData harus NULL karena sumber daya multisampel tidak dapat diinisialisasi dengan data saat dibuat.

[out] ppTexture3D

Jenis: ID3D10Texture3D**

Alamat penunjuk ke tekstur yang dibuat (lihat Antarmuka ID3D10Texture3D). Atur parameter ini ke NULL untuk memvalidasi parameter input lainnya (metode akan mengembalikan S_FALSE jika parameter input lainnya lolos validasi).

Menampilkan nilai

Jenis: HRESULT

Jika metode berhasil, kode pengembalian S_OK. Lihat Kode Pengembalian Direct3D 10 untuk kode kesalahan yang gagal.

Keterangan

CreateTexture3D membuat sumber daya tekstur 3D, yang berisi array tekstur 1D. Jumlah tekstur ditentukan dalam deskripsi tekstur. Semua tekstur dalam sumber daya harus memiliki format, ukuran, dan jumlah tingkat mipmap yang sama.

Semua sumber daya terdiri dari satu atau beberapa subsumber daya. Untuk memuat data ke dalam tekstur, aplikasi dapat menyediakan data pada awalnya sebagai bagian dari struktur D3D10_SUBRESOURCE_DATA yang ditunjukkan oleh pInitialData, atau dapat menggunakan salah satu Fungsi Tekstur yang disediakan oleh SDK.

Persyaratan

   
Target Platform Windows
Header d3d10.h
Pustaka D3D10.lib

Lihat juga

Antarmuka ID3D10Device