struktur DD_CALLBACKS (ddrawint.h)

Artikel
08/23/2023

Struktur DD_CALLBACKS berisi penunjuk entri ke fungsi panggilan balik yang didukung driver perangkat.

Sintaks

typedef struct DD_CALLBACKS {
  DWORD                    dwSize;
  DWORD                    dwFlags;
  PDD_DESTROYDRIVER        DestroyDriver;
  PDD_CREATESURFACE        CreateSurface;
  PDD_SETCOLORKEY          SetColorKey;
  PDD_SETMODE              SetMode;
  PDD_WAITFORVERTICALBLANK WaitForVerticalBlank;
  PDD_CANCREATESURFACE     CanCreateSurface;
  PDD_CREATEPALETTE        CreatePalette;
  PDD_GETSCANLINE          GetScanLine;
  PDD_MAPMEMORY            MapMemory;
} DD_CALLBACKS;

Anggota

dwSize

Menentukan ukuran dalam byte struktur ini.

dwFlags

Menunjukkan fungsi panggilan balik Microsoft DirectDraw apa yang telah diterapkan driver. Untuk setiap bit yang diatur dalam dwFlags, driver harus menginisialisasi anggota pointer fungsi yang sesuai dari struktur ini. Anggota ini bisa menjadi satu atau beberapa bendera berikut:

DDHAL_CB32_CANCREATESURFACE
DDHAL_CB32_CREATEPALETTE
DDHAL_CB32_CREATESURFACE
DDHAL_CB32_GETSCANLINE
DDHAL_CB32_MAPMEMORY
DDHAL_CB32_SETCOLORKEY
DDHAL_CB32_SETMODE
DDHAL_CB32_WAITFORVERTICALBLANK

DestroyDriver

Tidak digunakan pada Microsoft Windows 2000 dan yang lebih baru dan harus diabaikan oleh driver.

CreateSurface

Menunjuk ke panggilan balik DdCreateSurface yang disediakan driver.

SetColorKey

Menunjuk ke panggilan balik DdSetColorKey yang disediakan driver.

SetMode

Tidak digunakan pada Windows 2000 dan yang lebih baru dan harus diabaikan oleh driver.

WaitForVerticalBlank

Menunjuk ke panggilan balik DdWaitForVerticalBlank yang disediakan driver.

CanCreateSurface

Menunjuk ke panggilan balik DdCanCreateSurface yang disediakan driver.

CreatePalette

Menunjuk ke panggilan balik DdCreatePalette yang disediakan driver.

GetScanLine

Menunjuk ke panggilan balik DdGetScanLine yang disediakan driver.

MapMemory

Menunjuk ke panggilan balik DdMapMemory yang disediakan driver.

Keterangan

Entri yang tidak digunakan pengandar tampilan harus diatur ke NULL. GDI mengalokasikan memori untuk struktur ini dan memanggil fungsi DrvEnableDirectDraw driver untuk menginisialisasinya.