structure DD_SURFACECALLBACKS (ddrawint.h)

Article
03/06/2024

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

Syntaxe

typedef struct DD_SURFACECALLBACKS {
  DWORD                         dwSize;
  DWORD                         dwFlags;
  PDD_SURFCB_DESTROYSURFACE     DestroySurface;
  PDD_SURFCB_FLIP               Flip;
  PDD_SURFCB_SETCLIPLIST        SetClipList;
  PDD_SURFCB_LOCK               Lock;
  PDD_SURFCB_UNLOCK             Unlock;
  PDD_SURFCB_BLT                Blt;
  PDD_SURFCB_SETCOLORKEY        SetColorKey;
  PDD_SURFCB_ADDATTACHEDSURFACE AddAttachedSurface;
  PDD_SURFCB_GETBLTSTATUS       GetBltStatus;
  PDD_SURFCB_GETFLIPSTATUS      GetFlipStatus;
  PDD_SURFCB_UPDATEOVERLAY      UpdateOverlay;
  PDD_SURFCB_SETOVERLAYPOSITION SetOverlayPosition;
  LPVOID                        reserved4;
  PDD_SURFCB_SETPALETTE         SetPalette;
} DD_SURFACECALLBACKS;

Membres

dwSize

Spécifie la taille en octets de la structure DD_SURFACECALLBACKS. Ce membre n’est pas utilisé par Microsoft Windows 2000 et versions ultérieures.

dwFlags

Indique les fonctions de rappel DirectDrawSurface 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_SURFCB32_DESTROYSURFACE
DDHAL_SURFCB32_FLIP
DDHAL_SURFCB32_SETCLIPLIST
DDHAL_SURFCB32_LOCK
DDHAL_SURFCB32_UNLOCK
DDHAL_SURFCB32_BLT
DDHAL_SURFCB32_SETCOLORKEY
DDHAL_SURFCB32_ADDATTACHEDSURFACE
DDHAL_SURFCB32_GETBLTSTATUS
DDHAL_SURFCB32_GETFLIPSTATUS
DDHAL_SURFCB32_UPDATEOVERLAY
DDHAL_SURFCB32_SETOVERLAYPOSITION
DDHAL_SURFCB32_SETPALETTE

DestroySurface

Pointe vers le rappel de surface DdDestroySurface fourni par le pilote.

Flip

Pointe vers le rappel de surface DdFlip fourni par le pilote.

SetClipList

Pointe vers le rappel de surface DdSetClipList fourni par le pilote.

Lock

Pointe vers le rappel de surface DdLock fourni par le pilote.

Unlock

Pointe vers le rappel de surface DdUnlock fourni par le pilote.

Blt

Pointe vers le rappel de surface DdBlt fourni par le pilote.

SetColorKey

Pointe vers le rappel de surface DdSetColorKey fourni par le pilote.

AddAttachedSurface

Pointe vers le rappel de surface DdAddAttachedSurface fourni par le pilote.

GetBltStatus

Pointe vers le rappel de surface DdGetBltStatus fourni par le pilote.

GetFlipStatus

Pointe vers le rappel de surface DdGetFlipStatus fourni par le pilote.

UpdateOverlay

Pointe vers le rappel de surface DdUpdateOverlay fourni par le pilote.

SetOverlayPosition

Pointe vers le rappel de surface DdSetOverlayPosition fourni par le pilote.

reserved4

Réservé à l’utilisation du système et doit être ignoré par le pilote.

SetPalette

Pointe vers le rappel de surface DdSetPalette fourni par le pilote.

Remarques

Les entrées que le pilote d’affichage n’utilise pas doivent être définies sur NULL. Le pilote initialise cette structure dans DrvEnableDirectDraw.