struktur D3DHAL_CALLBACKS (d3dhal.h)

Artikel
02/26/2024

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

Sintaks

typedef struct _D3DHAL_CALLBACKS {
  DWORD                        dwSize;
  LPD3DHAL_CONTEXTCREATECB     ContextCreate;
  LPD3DHAL_CONTEXTDESTROYCB    ContextDestroy;
  LPD3DHAL_CONTEXTDESTROYALLCB ContextDestroyAll;
  LPD3DHAL_SCENECAPTURECB      SceneCapture;
  LPVOID                       lpReserved10;
  LPVOID                       lpReserved11;
  LPD3DHAL_RENDERSTATECB       RenderState;
  LPD3DHAL_RENDERPRIMITIVECB   RenderPrimitive;
  DWORD                        dwReserved;
  LPD3DHAL_TEXTURECREATECB     TextureCreate;
  LPD3DHAL_TEXTUREDESTROYCB    TextureDestroy;
  LPD3DHAL_TEXTURESWAPCB       TextureSwap;
  LPD3DHAL_TEXTUREGETSURFCB    TextureGetSurf;
  LPVOID                       lpReserved12;
  LPVOID                       lpReserved13;
  LPVOID                       lpReserved14;
  LPVOID                       lpReserved15;
  LPVOID                       lpReserved16;
  LPVOID                       lpReserved17;
  LPVOID                       lpReserved18;
  LPVOID                       lpReserved19;
  LPVOID                       lpReserved20;
  LPVOID                       lpReserved21;
  LPD3DHAL_GETSTATECB          GetState;
  DWORD                        dwReserved0;
  DWORD                        dwReserved1;
  DWORD                        dwReserved2;
  DWORD                        dwReserved3;
  DWORD                        dwReserved4;
  DWORD                        dwReserved5;
  DWORD                        dwReserved6;
  DWORD                        dwReserved7;
  DWORD                        dwReserved8;
  DWORD                        dwReserved9;
} D3DHAL_CALLBACKS, *LPD3DHAL_CALLBACKS;

Anggota

dwSize

Menentukan ukuran dalam byte struktur D3DHAL_CALLBACKS ini.

ContextCreate

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

ContextDestroy

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

ContextDestroyAll

Harus diatur ke NULL di driver Windows 2000 dan yang lebih baru.

SceneCapture

Harus diatur ke NULL di driver Windows 2000 dan yang lebih baru. Untuk DirectX 6.0, ini adalah penunjuk ke panggilan balik D3dSceneCapture yang disediakan driver. Untuk DirectX 7.0 dan yang lebih baru, panggilan balik ini digantikan oleh penanganan status render D3DRENDERSTATE_SCENECAPTURE dalam fungsi D3dDrawPrimitives2 .

lpReserved10

Harus nol.

lpReserved11

Harus nol.

RenderState

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

RenderPrimitive

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

dwReserved

Menentukan bidang yang dipesan dan harus diatur ke nol.

TextureCreate

Harus diatur ke NULL di driver Windows 2000 dan yang lebih baru. Untuk DirectX 6.0, ini adalah penunjuk ke panggilan balik D3dTextureCreate yang disediakan driver, atau NULL.

TextureDestroy

Harus diatur ke NULL di driver Windows 2000 dan yang lebih baru. Untuk DirectX 6.0, ini adalah penunjuk ke panggilan balik D3dTextureDestroy yang disediakan driver, atau NULL.

TextureSwap

Harus diatur ke NULL di driver Windows 2000 dan yang lebih baru. Untuk DirectX 6.0, ini adalah penunjuk ke panggilan balik D3dTextureSwap yang disediakan driver, atau NULL.

TextureGetSurf

Harus diatur ke NULL di driver Windows 2000 dan yang lebih baru. Untuk DirectX 6.0, ini adalah penunjuk ke panggilan balik D3dTextureGetSurf yang disediakan driver, atau NULL.

lpReserved12

Harus nol.

lpReserved13

Harus nol.

lpReserved14

Harus nol.

lpReserved15

Harus nol.

lpReserved16

Harus nol.

lpReserved17

Harus nol.

lpReserved18

Harus nol.

lpReserved19

Harus nol.

lpReserved20

Harus nol.

lpReserved21

Harus nol.

GetState

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

dwReserved0

Harus nol.

dwReserved1

Harus nol.

dwReserved2

Harus nol.

dwReserved3

Harus nol.

dwReserved4

Harus nol.

dwReserved5

Harus nol.

dwReserved6

Harus nol.

dwReserved7

Harus nol.

dwReserved8

Harus nol

dwReserved9

Harus nol.

Keterangan

Driver mengalokasikan struktur ini dan menetapkan nilai yang sesuai di semua anggota. Fungsi DrvGetDirectDrawInfo driver mengembalikan pointer ke struktur ini di anggota lpD3DHALCallbacks dari struktur DD_HALINFO .

Manajemen tekstur sekarang ditangani meskipun opcode yang dikelola dalam implementasi driver D3dDrawPrimitives2.