Metode IDirect3DDevice9::SetSoftwareVertexProcessing (d3d9helper.h)

  • Artikel

Gunakan metode ini untuk beralih antara pemrosesan puncak perangkat lunak dan perangkat keras.

Sintaks

HRESULT SetSoftwareVertexProcessing(
  [in] BOOL bSoftware
);

Parameter

[in] bSoftware

Jenis: BOOL

TRUE untuk menentukan pemrosesan puncak perangkat lunak; FALSE untuk menentukan pemrosesan puncak perangkat keras.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Pembatasan untuk mengubah mode adalah sebagai berikut (juga lihat catatan pada konstanta D3DCREATE ):

  • Jika perangkat dibuat dengan D3DCREATE_SOFTWARE_VERTEXPROCESSING, pemrosesan puncak akan dilakukan dalam perangkat lunak dan tidak dapat diubah.
  • Jika perangkat dibuat dengan D3DCREATE_HARDWARE_VERTEXPROCESSING, pemrosesan puncak akan dilakukan di perangkat keras dan tidak dapat diubah.
  • Jika perangkat dibuat dengan D3DCREATE_MIXED_VERTEXPROCESSING, pemrosesan puncak akan dilakukan di perangkat keras secara default. Pemrosesan dapat dialihkan ke perangkat lunak (atau kembali ke perangkat keras) menggunakan IDirect3DDevice9::SetSoftwareVertexProcessing.
Aplikasi dapat membuat perangkat mode campuran untuk menggunakan pemrosesan vertex perangkat lunak dan pemrosesan vertex perangkat keras. Untuk beralih di antara dua mode pemrosesan vertex di DirectX 8.x, gunakan IDirect3DDevice8::SetRenderState dengan status render D3DRS_SOFTWAREVERTEXPROCESSING dan argumen DWORD yang sesuai. Kelemahan pendekatan status render adalah kesulitan dalam mendefinisikan semantik untuk blok status. Aplikasi dan runtime harus melakukan pekerjaan ekstra dan berhati-hati saat merekam dan memutar blok status kembali.

Di Direct3D 9, gunakan SetSoftwareVertexProcessing sebagai gantinya. API baru ini tidak direkam oleh StateBlocks.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header d3d9helper.h (termasuk D3D9.h)
Pustaka D3D9.lib

Lihat juga

IDirect3DDevice9

IDirect3DDevice9::GetSoftwareVertexProcessing