structure DD_CALLBACKS (ddrawint.h)

Article
02/26/2024

La structure DD_CALLBACKS contient des pointeurs d’entrée vers les fonctions de rappel qu’un pilote de périphérique prend en charge.

Syntaxe

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;

Membres

dwSize

Spécifie la taille en octets de cette structure.

dwFlags

Indique les fonctions de rappel Microsoft DirectDraw que le pilote a implémentées. Pour chaque bit défini dans dwFlags, le pilote doit initialiser le membre de pointeur de fonction correspondant de cette structure. Ce membre peut être un ou plusieurs des indicateurs suivants :

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

Non utilisé sur Microsoft Windows 2000 et versions ultérieures et doit être ignoré par le pilote.

CreateSurface

Pointe vers le rappel DdCreateSurface fourni par le pilote.

SetColorKey

Pointe vers le rappel DdSetColorKey fourni par le pilote.

SetMode

Non utilisé sur Windows 2000 et versions ultérieures et doit être ignoré par le pilote.

WaitForVerticalBlank

Pointe vers le rappel DdWaitForVerticalBlank fourni par le pilote.

CanCreateSurface

Pointe vers le rappel DdCanCreateSurface fourni par le pilote.

CreatePalette

Pointe vers le rappel DdCreatePalette fourni par le pilote.

GetScanLine

Pointe vers le rappel DdGetScanLine fourni par le pilote.

MapMemory

Pointe vers le rappel DdMapMemory fourni par le pilote.

Remarques

Les entrées que le pilote d’affichage n’utilise pas doivent être définies sur NULL. GDI alloue la mémoire pour cette structure et appelle la fonction DrvEnableDirectDraw du pilote pour l’initialiser.