структура DD_CALLBACKS (ddrawint.h)

Статья
03/05/2024

Структура DD_CALLBACKS содержит указатели на функции обратного вызова, поддерживаемые драйвером устройства.

Синтаксис

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;

Члены

dwSize

Задает размер этой структуры в байтах.

dwFlags

Указывает функции обратного вызова Microsoft DirectDraw, реализованные драйвером. Для каждого бита, заданного в dwFlags, драйвер должен инициализировать соответствующий элемент указателя функции этой структуры. Этот элемент может быть одним или несколькими из следующих флагов:

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

Не используется в Microsoft Windows 2000 и более поздних версиях и должен игнорироваться драйвером.

CreateSurface

Указывает на предоставленный драйвером обратный вызов DdCreateSurface .

SetColorKey

Указывает на предоставленный драйвером обратный вызов DdSetColorKey .

SetMode

Не используется в Windows 2000 и более поздних версиях и должен игнорироваться драйвером.

WaitForVerticalBlank

Указывает на предоставленный драйвером обратный вызов DdWaitForVerticalBlank .

CanCreateSurface

Указывает на предоставленный драйвером обратный вызов DdCanCreateSurface .

CreatePalette

Указывает на предоставленный драйвером обратный вызов DdCreatePalette .

GetScanLine

Указывает на предоставленный драйвером обратный вызов DdGetScanLine .

MapMemory

Указывает на предоставленный драйвером обратный вызов DdMapMemory .

Записи, которые не используются драйвером отображения, должны иметь значение NULL. GDI выделяет память для этой структуры и вызывает функцию DrvEnableDirectDraw драйвера для ее инициализации.