DD_SURFACECALLBACKS-Struktur (ddrawint.h)

Artikel
08/23/2023

Die DD_SURFACECALLBACKS-Struktur enthält Einstiegszeiger auf die Microsoft DirectDraw-Surface-Rückruffunktionen, die ein Gerätetreiber unterstützt.

Syntax

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;

Member

dwSize

Gibt die Größe der DD_SURFACECALLBACKS-Struktur in Bytes an. Dieses Element wird von Microsoft Windows 2000 und höheren Versionen nicht verwendet.

dwFlags

Gibt an, welche DirectDrawSurface-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_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

Verweist auf den vom Treiber bereitgestellten DdDestroySurface-Surface-Rückruf .

Flip

Verweist auf den vom Treiber bereitgestellten DdFlip-Surface-Rückruf .

SetClipList

Verweist auf den vom Treiber bereitgestellten DdSetClipList-Oberflächenrückruf .

Lock

Verweist auf den vom Treiber bereitgestellten DdLock-Oberflächenrückruf .

Unlock

Zeigt auf den vom Treiber bereitgestellten DdUnlock Surface Callback.

Blt

Verweist auf den vom Treiber bereitgestellten DdBlt-Surface-Rückruf .

SetColorKey

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

AddAttachedSurface

Verweist auf den vom Treiber bereitgestellten DdAddAttachedSurface-Oberflächenrückruf .

GetBltStatus

Verweist auf den vom Treiber bereitgestellten DdGetBltStatus-Surface-Rückruf .

GetFlipStatus

Verweist auf den vom Treiber bereitgestellten DdGetFlipStatus-Surface-Rückruf .

UpdateOverlay

Verweist auf den vom Treiber bereitgestellten DdUpdateOverlay-Surface-Rückruf .

SetOverlayPosition

Verweist auf den vom Treiber bereitgestellten DdSetOverlayPosition-Surface-Rückruf .

reserved4

Für die Systemverwendung reserviert und sollte vom Treiber ignoriert werden.

SetPalette

Verweist auf den vom Treiber bereitgestellten DdSetPalette-Surface-Rückruf .

Hinweise

Einträge, die der Anzeigetreiber nicht verwendet, sollten auf NULL festgelegt werden. Der Treiber initialisiert diese Struktur in DrvEnableDirectDraw.