DD_CALLBACKS struttura (ddrawint.h)

Articolo
02/29/2024

La struttura DD_CALLBACKS contiene puntatori di ingresso alle funzioni di callback supportate da un driver di dispositivo.

Sintassi

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;

Members

dwSize

Specifica le dimensioni in byte di questa struttura.

dwFlags

Indica le funzioni di callback di Microsoft DirectDraw implementate dal driver. Per ogni set di bit in dwFlags, il driver deve inizializzare il membro del puntatore della funzione corrispondente di questa struttura. Questo membro può essere uno o più dei flag seguenti:

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

Inutilizzato in Microsoft Windows 2000 e versioni successive e deve essere ignorato dal driver.

CreateSurface

Punta al callback DdCreateSurface fornito dal driver.

SetColorKey

Punta al callback DdSetColorKey fornito dal driver.

SetMode

Inutilizzato in Windows 2000 e versioni successive e deve essere ignorato dal driver.

WaitForVerticalBlank

Punta al callback DdWaitForVerticalBlank fornito dal driver.

CanCreateSurface

Punta al callback DdCanCreateSurface fornito dal driver.

CreatePalette

Punta al callback DdCreatePalette fornito dal driver.

GetScanLine

Punta al callback DdGetScanLine fornito dal driver.

MapMemory

Punta al callback DdMapMemory fornito dal driver.

Commenti

Le voci usate dal driver di visualizzazione non devono essere impostate su NULL. GDI alloca la memoria per questa struttura e chiama la funzione DrvEnableDirectDraw del driver per inizializzarla.