Metode IDirect3DDevice9::CreateStateBlock (d3d9helper.h)

Artikel
02/29/2024

Membuat blok status baru yang berisi nilai untuk semua status perangkat, status terkait vertex, atau status terkait piksel.

Sintaks

HRESULT CreateStateBlock(
  [in]          D3DSTATEBLOCKTYPE    Type,
  [out, retval] IDirect3DStateBlock9 **ppSB
);

Parameter

[in] Type

Jenis: D3DSTATEBLOCKTYPE

Jenis data status yang harus diambil metode . Parameter ini dapat diatur ke nilai yang ditentukan dalam jenis D3DSTATEBLOCKTYPE yang dijumlahkan.

[out, retval] ppSB

Jenis: IDirect3DStateBlock9**

Penunjuk ke antarmuka blok status. Lihat IDirect3DStateBlock9.

Nilai kembali

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan adalah D3D_OK. Jika metode gagal, nilai yang dikembalikan dapat menjadi salah satu dari yang berikut: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.

Keterangan

Status perangkat terkait verteks biasanya mengacu pada status yang memengaruhi cara sistem memproses simpul. Status terkait piksel umumnya mengacu pada status perangkat yang memengaruhi cara sistem memproses data piksel atau buffer kedalaman selama rasterisasi. Beberapa status terkandung dalam kedua grup.

Perbedaan antara Direct3D 9 dan Direct3D 10:

Di Direct3D 9, blok status berisi data status, untuk status yang diminta untuk diambil, saat objek dibuat. Untuk mengubah nilai blok status, panggil IDirect3DStateBlock9::Capture atau IDirect3DDevice9::BeginStateBlock/IDirect3DDevice9::EndStateBlock. Tidak ada status yang disimpan ketika objek blok status dibuat di Direct3D 10.