ID3D11Device::Metode CreateInputLayout (d3d11.h)

Artikel
02/24/2024

Buat objek input-layout untuk menjelaskan data input-buffer untuk tahap input-assembler.

Sintaks

HRESULT CreateInputLayout(
  [in]            const D3D11_INPUT_ELEMENT_DESC *pInputElementDescs,
  [in]            UINT                           NumElements,
  [in]            const void                     *pShaderBytecodeWithInputSignature,
  [in]            SIZE_T                         BytecodeLength,
  [out, optional] ID3D11InputLayout              **ppInputLayout
);

Parameter

[in] pInputElementDescs

Jenis: const D3D11_INPUT_ELEMENT_DESC*

Array jenis data input-assembler stage input; setiap jenis dijelaskan oleh deskripsi elemen (lihat D3D11_INPUT_ELEMENT_DESC).

[in] NumElements

Jenis: UINT

Jumlah jenis input-data dalam array elemen input.

[in] pShaderBytecodeWithInputSignature

Jenis: const void*

Penunjuk ke shader yang dikompilasi. Kode shader yang dikompilasi berisi tanda tangan input yang divalidasi terhadap array elemen. Lihat komentar.

[in] BytecodeLength

Jenis: SIZE_T

Ukuran shader yang dikompilasi.

[out, optional] ppInputLayout

Jenis: ID3D11InputLayout**

Penunjuk ke objek tata letak input yang dibuat (lihat ID3D11InputLayout). Untuk memvalidasi parameter input lainnya, atur pointer ini menjadi NULL dan verifikasi bahwa metode mengembalikan S_FALSE.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Setelah membuat objek tata letak input, objek harus terikat ke tahap perakitan input sebelum memanggil API gambar.

Setelah objek tata letak input dibuat dari tanda tangan shader, objek tata letak input dapat digunakan kembali dengan shader lain yang memiliki tanda tangan input yang identik (termasuk semantik). Ini dapat menyederhanakan pembuatan objek tata letak input saat Anda bekerja dengan banyak shader dengan input yang identik.

Jika jenis data dalam deklarasi tata letak input tidak cocok dengan jenis data dalam tanda tangan shader-input, CreateInputLayout akan menghasilkan peringatan selama kompilasi. Peringatannya hanya untuk menarik perhatian pada fakta bahwa data dapat diinterpretasikan kembali saat dibaca dari register. Anda dapat mengabaikan peringatan ini (jika reinterpretasi disengaja) atau membuat jenis data cocok di kedua deklarasi untuk menghilangkan peringatan.

Windows Phone 8: API ini didukung.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	d3d11.h
Pustaka	D3D11.lib

Lihat juga

ID3D11Device