Metode IDirect3DDevice9::D rawPrimitiveUP (d3d9helper.h)
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 D3DPRIMITIVETYPE yang dijumlahkan, 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.
Nilai kembali
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.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Windows |
| Header | d3d9helper.h (termasuk D3D9.h) |
| Pustaka | D3D9.lib |