estrutura DD_CALLBACKS (ddrawint.h)

Artigo
08/23/2023

A estrutura DD_CALLBACKS contém ponteiros de entrada para as funções de retorno de chamada compatíveis com um driver de dispositivo.

Sintaxe

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;

Membros

dwSize

Especifica o tamanho em bytes dessa estrutura.

dwFlags

Indica quais funções de retorno de chamada do Microsoft DirectDraw o driver implementou. Para cada conjunto de bits em dwFlags, o driver deve inicializar o membro do ponteiro de função correspondente dessa estrutura. Esse membro pode ser um ou mais dos seguintes sinalizadores:

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

Não utilizado no Microsoft Windows 2000 e posterior e deve ser ignorado pelo driver.

CreateSurface

Aponta para o retorno de chamada DdCreateSurface fornecido pelo driver.

SetColorKey

Aponta para o retorno de chamada DdSetColorKey fornecido pelo driver.

SetMode

Não utilizado no Windows 2000 e posterior e deve ser ignorado pelo driver.

WaitForVerticalBlank

Aponta para o retorno de chamada DdWaitForVerticalBlank fornecido pelo driver.

CanCreateSurface

Aponta para o retorno de chamada DdCanCreateSurface fornecido pelo driver.

CreatePalette

Aponta para o retorno de chamada DdCreatePalette fornecido pelo driver.

GetScanLine

Aponta para o retorno de chamada DdGetScanLine fornecido pelo driver.

MapMemory

Aponta para o retorno de chamada DdMapMemory fornecido pelo driver.

Comentários

As entradas que o driver de exibição não usa devem ser definidas como NULL. O GDI aloca a memória dessa estrutura e chama a função DrvEnableDirectDraw do driver para inicializá-la.