estrutura DD_MISCELLANEOUS2CALLBACKS (ddrawint.h)

Artigo
02/29/2024

A estrutura DD_MISCELLANEOUS2CALLBACKS é usada para retornar os endereços de diversas rotinas de retorno de chamada. Essas rotinas são novas para o Microsoft DirectX 7.0 e posterior e são expostas por meio de DdGetDriverInfo respondendo ao GUID do GUID_Miscellaneous2Callbacks.

Sintaxe

typedef struct _DD_MISCELLANEOUS2CALLBACKS {
  DWORD               dwSize;
  DWORD               dwFlags;
  PDD_ALPHABLT        AlphaBlt;
  PDD_CREATESURFACEEX CreateSurfaceEx;
  PDD_GETDRIVERSTATE  GetDriverState;
  PDD_DESTROYDDLOCAL  DestroyDDLocal;
} DD_MISCELLANEOUS2CALLBACKS, *PDD_MISCELLANEOUS2CALLBACKS;

Membros

dwSize

Especifica o tamanho, em bytes, dessa estrutura.

dwFlags

Indica quais funções de retorno de chamada diversas o driver implementou. Para cada bit definido 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_MISC2CB32_CREATESURFACEEX
DDHAL_MISC2CB32_GETDRIVERSTATE
DDHAL_MISC2CB32_DESTROYDDLOCAL

AlphaBlt

Não utilizado e deve ser definido como NULL.

CreateSurfaceEx

Aponta para a implementação D3dCreateSurfaceEx do driver. Esse retorno de chamada cria uma associação entre uma superfície DirectDraw e um identificador inteiro pequeno.

GetDriverState

Aponta para a implementação D3dGetDriverState do driver.

DestroyDDLocal

Aponta para a implementação D3dDestroyDDLocal do driver. Usado para destruir a cópia local do contexto do dispositivo.