DD_CALLBACKS Struktur (ddrawint.h)

Artikel
02/26/2024

Die DD_CALLBACKS-Struktur enthält Einstiegszeiger auf die Rückruffunktionen, die ein Gerätetreiber unterstützt.

Syntax

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;

Member

dwSize

Gibt die Größe dieser Struktur in Bytes an.

dwFlags

Gibt an, welche Microsoft DirectDraw-Rückruffunktionen der Treiber implementiert hat. Für jedes in dwFlags festgelegte Bit muss der Treiber das entsprechende Funktionszeigerelement dieser Struktur initialisieren. Bei diesem Member kann es sich um mindestens eins der folgenden Flags handelt:

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

Nicht verwendet unter Microsoft Windows 2000 und höher und sollte vom Treiber ignoriert werden.

CreateSurface

Verweist auf den vom Treiber bereitgestellten DdCreateSurface-Rückruf .

SetColorKey

Verweist auf den vom Treiber bereitgestellten DdSetColorKey-Rückruf .

SetMode

Unter Windows 2000 und höher nicht verwendet und sollte vom Treiber ignoriert werden.

WaitForVerticalBlank

Verweist auf den vom Treiber bereitgestellten DdWaitForVerticalBlank-Rückruf .

CanCreateSurface

Verweist auf den vom Treiber bereitgestellten DdCanCreateSurface-Rückruf .

CreatePalette

Verweist auf den vom Treiber bereitgestellten DdCreatePalette-Rückruf .

GetScanLine

Verweist auf den vom Treiber bereitgestellten DdGetScanLine-Rückruf .

MapMemory

Verweist auf den vom Treiber bereitgestellten DdMapMemory-Rückruf .

Hinweise

Einträge, die der Anzeigetreiber nicht verwendet, sollten auf NULL festgelegt werden. GDI weist den Arbeitsspeicher für diese Struktur zu und ruft die DrvEnableDirectDraw-Funktion des Treibers auf, um sie zu initialisieren.