struktur D3DHAL_CALLBACKS3 (d3dhal.h)

Artikel
03/08/2023

D3DHAL_CALLBACKS3 adalah salah satu dari beberapa struktur panggilan balik yang menjelaskan dukungan Direct3D yang disediakan oleh driver.

Sintaks

typedef struct _D3DHAL_CALLBACKS3 {
  DWORD                                dwSize;
  DWORD                                dwFlags;
  LPD3DHAL_CLEAR2CB                    Clear2;
  LPVOID                               lpvReserved;
  LPD3DHAL_VALIDATETEXTURESTAGESTATECB ValidateTextureStageState;
  LPD3DHAL_DRAWPRIMITIVES2CB           DrawPrimitives2;
} D3DHAL_CALLBACKS3, *LPD3DHAL_CALLBACKS3;

Anggota

dwSize

Menentukan ukuran dalam byte struktur ini.

dwFlags

Menunjukkan panggilan balik yang terkait dengan struktur ini yang telah diterapkan driver. Untuk setiap bit yang ditetapkan driver dalam dwFlags, driver harus menginisialisasi anggota penunjuk fungsi yang sesuai dari struktur ini. Anggota ini bisa menjadi bitwise-OR dari satu atau beberapa bendera berikut:

Bendera	Makna
D3DHAL3_CB32_CLEAR2	Tidak digunakan dalam DirectX 7.0 dan versi yang lebih baru.
D3DHAL3_CB32_DRAWPRIMITIVES2	DrawPrimitives2member menunjuk ke panggilan balik D3dDrawPrimitives2 yang diimplementasikan driver.
D3DHAL3_CB32_RESERVED	Tidak digunakan dalam DirectX 7.0 dan versi yang lebih baru.
D3DHAL3_CB32_VALIDATETEXTURESTAGESTATE	ValidateTextureStageStatemember menunjuk ke panggilan balik D3dValidateTextureStageState yang diimplementasikan driver.

Clear2

Harus diatur ke NULL. Ini adalah penunjuk ke panggilan balik D3dClear2 yang disediakan driver yang tidak lagi digunakan untuk DirectX 7.0 dan seterusnya. Sebaliknya driver harus merespons token aliran perintah D3DDP2OP_CLEAR dalam implementasi D3dDrawPrimitives2.

lpvReserved

Menentukan bidang yang dipesan dan harus diatur ke NULL di driver Windows 2000 dan yang lebih baru.

ValidateTextureStageState

Menunjuk ke panggilan balik D3dValidateTextureStageState yang disediakan driver, atau NULL. Driver yang mendukung multitekstur harus mengimplementasikan panggilan balik yang dirujuk anggota ini.

DrawPrimitives2

Menunjuk ke panggilan balik D3dDrawPrimitives2 yang disediakan driver. Driver harus menerapkan panggilan balik yang dirujuk anggota ini.

Keterangan

Driver mengalokasikan struktur ini dan menetapkan nilai yang sesuai di semua anggota. Fungsi DdGetDriverInfo driver mengembalikan penunjuk ke struktur ini ketika fungsi tersebut dipanggil dengan GUID GUID_D3DCallbacks3.