Metode IDirect3DDevice9::CreateIndexBuffer (d3d9helper.h)

Artikel
08/23/2023

Membuat buffer indeks.

Sintaks

HRESULT CreateIndexBuffer(
  [in]          UINT                  Length,
  [in]          DWORD                 Usage,
  [in]          D3DFORMAT             Format,
  [in]          D3DPOOL               Pool,
  [out, retval] IDirect3DIndexBuffer9 **ppIndexBuffer,
  [in]          HANDLE                *pSharedHandle
);

Parameter

[in] Length

Jenis: UINT

Ukuran buffer indeks, dalam byte.

[in] Usage

Jenis: DWORD

Penggunaan bisa 0, yang menunjukkan tidak ada nilai penggunaan. Namun, jika penggunaan diinginkan, gunakan kombinasi satu atau beberapa konstanta D3DUSAGE . Adalah praktik yang baik untuk mencocokkan parameter penggunaan di CreateIndexBuffer dengan bendera perilaku di IDirect3D9::CreateDevice. Untuk informasi selengkapnya, lihat Keterangan.

[in] Format

Jenis: D3DFORMAT

Anggota jenis enumerasi D3DFORMAT , yang menjelaskan format buffer indeks. Untuk informasi selengkapnya, lihat Keterangan. Pengaturan yang valid adalah sebagai berikut:

Item	Deskripsi
D3DFMT_INDEX16	Indeks masing-masing 16 bit.
D3DFMT_INDEX32	Indeks masing-masing 32 bit.

[in] Pool

Jenis: D3DPOOL

Anggota jenis D3DPOOL yang dijumlahkan, menjelaskan kelas memori yang valid untuk menempatkan sumber daya.

[out, retval] ppIndexBuffer

Jenis: IDirect3DIndexBuffer9**

Alamat penunjuk ke antarmuka IDirect3DIndexBuffer9 , mewakili sumber daya buffer indeks yang dibuat.

[in] pSharedHandle

Jenis: HANDEL*

Parameter ini dapat digunakan di Direct3D 9 untuk Windows Vista untuk berbagi sumber daya; atur ke NULL untuk tidak berbagi sumber daya. Parameter ini tidak digunakan dalam Direct3D 9 untuk sistem operasi yang lebih lama dari Windows Vista; atur ke NULL.

Mengembalikan nilai

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan D3D_OK. Jika metode gagal, nilai yang dikembalikan dapat berupa salah satu hal berikut: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Keterangan

Buffer indeks adalah sumber daya memori yang digunakan untuk menyimpan indeks, mereka mirip dengan permukaan dan buffer vertex. Penggunaan buffer indeks memungkinkan Direct3D untuk menghindari penyalinan data yang tidak perlu dan menempatkan buffer dalam jenis memori optimal untuk penggunaan yang diharapkan.

Untuk menggunakan buffer indeks, membuat buffer indeks, menguncinya, mengisinya dengan indeks, membukanya, meneruskannya ke IDirect3DDevice9::SetIndices, menyiapkan simpul, menyiapkan shader vertex, dan memanggil IDirect3DDevice9::D rawIndexedPrimitive untuk penyajian.

Anggota MaxVertexIndex dari struktur D3DCAPS9 menunjukkan jenis buffer indeks yang valid untuk penyajian.