Metode IDirect3DDevice9::D rawPrimitiveUP (d3d9.h)

Artikel
08/23/2023

Merender data yang ditentukan oleh penunjuk memori pengguna sebagai urutan primitif geometris dari jenis yang ditentukan.

Sintaks

HRESULT DrawPrimitiveUP(
  [in] D3DPRIMITIVETYPE PrimitiveType,
  [in] UINT             PrimitiveCount,
  [in] const void       *pVertexStreamZeroData,
  [in] UINT             VertexStreamZeroStride
);

Parameter

[in] PrimitiveType

Jenis: D3DPRIMITIVETYPE

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

[in] PrimitiveCount

Jenis: UINT

Jumlah primitif yang akan dirender. Jumlah maksimum primitif yang diizinkan ditentukan dengan memeriksa anggota MaxPrimitiveCount dari struktur D3DCAPS9 .

[in] pVertexStreamZeroData

Jenis: const void*

Penunjuk memori pengguna ke data puncak.

[in] VertexStreamZeroStride

Jenis: UINT

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

Menampilkan nilai

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan D3D_OK. Jika metode gagal, nilai yang dikembalikan dapat berupa: D3DERR_INVALIDCALL.

Keterangan

Metode ini ditujukan untuk digunakan dalam aplikasi yang tidak dapat menyimpan data vertex mereka dalam buffer vertex. Metode ini hanya mendukung satu aliran puncak. Efek dari panggilan ini adalah menggunakan penunjuk data vertex yang disediakan dan melangkah untuk aliran vertex 0. Tidak valid untuk memiliki deklarasi shader vertex saat ini mengacu pada aliran vertex selain aliran 0.

Mengikuti panggilan IDirect3DDevice9::D rawPrimitiveUP , pengaturan stream 0, yang dirujuk oleh IDirect3DDevice9::GetStreamSource, diatur ke NULL.

Data vertex yang diteruskan ke IDirect3DDevice9::D rawPrimitiveUP 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.