Metode IDirect3DDevice9::D rawIndexedPrimitiveUP (d3d9.h)

Artikel
03/09/2024

Merender primitif geometris yang ditentukan dengan data yang ditentukan oleh penunjuk memori pengguna.

Sintaks

HRESULT DrawIndexedPrimitiveUP(
  [in] D3DPRIMITIVETYPE PrimitiveType,
  [in] UINT             MinVertexIndex,
  [in] UINT             NumVertices,
  [in] UINT             PrimitiveCount,
  [in] const void       *pIndexData,
  [in] D3DFORMAT        IndexDataFormat,
  [in] const void       *pVertexStreamZeroData,
  [in] UINT             VertexStreamZeroStride
);

Parameter

[in] PrimitiveType

Jenis: D3DPRIMITIVETYPE

Anggota jenis D3DPRIMITIVETYPE yang dijumlahkan, yang menjelaskan jenis primitif yang akan dirender.

[in] MinVertexIndex

Jenis: UINT

Indeks puncak minimum. Ini adalah indeks berbasis nol.

[in] NumVertices

Jenis: UINT

Jumlah simpul yang digunakan selama panggilan ini. Puncak pertama terletak di indeks: MinVertexIndex.

[in] PrimitiveCount

Jenis: UINT

Jumlah primitif yang akan dirender. Jumlah maksimum primitif yang diizinkan ditentukan dengan memeriksa anggota MaxPrimitiveCount dari struktur D3DCAPS9 (jumlah indeks adalah fungsi dari jumlah primitif dan jenis primitif).

[in] pIndexData

Jenis: const void*

Penunjuk memori pengguna ke data indeks.

[in] IndexDataFormat

Jenis: D3DFORMAT

Anggota jenis D3DFORMAT yang dijumlahkan, yang menjelaskan format data indeks. Pengaturan yang valid adalah:

[in] pVertexStreamZeroData

Jenis: const void*

Penunjuk memori pengguna ke data puncak. Data puncak harus berada di aliran 0.

[in] VertexStreamZeroStride

Jenis: UINT

Jumlah byte data untuk setiap puncak. Nilai ini mungkin bukan 0.

Mengembalikan nilai

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan adalah D3D_OK. Jika metode gagal, nilai yang dikembalikan bisa menjadi berikut: D3DERR_INVALIDCALL.

Keterangan

Metode ini ditujukan untuk digunakan dalam aplikasi yang tidak dapat menyimpan data vertex mereka dalam buffer vertex. Metode ini hanya mendukung aliran vertex tunggal, yang harus dideklarasikan sebagai stream 0.

Mengikuti panggilan IDirect3DDevice9::D rawIndexedPrimitiveUP , pengaturan stream 0, yang direferensikan oleh IDirect3DDevice9::GetStreamSource, diatur ke NULL. Selain itu, pengaturan buffer indeks untuk IDirect3DDevice9::SetIndices diatur ke NULL.

Data puncak yang diteruskan ke IDirect3DDevice9::D rawIndexedPrimitiveUP tidak perlu bertahan setelah panggilan. Direct3D menyelesaikan aksesnya ke data tersebut sebelum kembali dari panggilan.

Saat mengonversi aplikasi warisan ke Direct3D 9, Anda harus menambahkan panggilan ke IDirect3DDevice9::SetFVF untuk menggunakan alur fungsi tetap, atau IDirect3DDevice9::SetVertexDeclaration untuk menggunakan shader vertex sebelum Anda melakukan panggilan Draw.