estructura DD_MISCELLANEOUS2CALLBACKS (ddrawint.h)

Artículo
08/23/2023

La estructura DD_MISCELLANEOUS2CALLBACKS se usa para devolver las direcciones de rutinas de devolución de llamada varias. Estas rutinas son nuevas para Microsoft DirectX 7.0 y versiones posteriores y se exponen a través de DdGetDriverInfo respondiendo al GUID de GUID_Miscellaneous2Callbacks.

Sintaxis

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

Miembros

dwSize

Especifica el tamaño, en bytes, de esta estructura.

dwFlags

Indica las funciones de devolución de llamada varias que implementó el controlador. Para cada bit establecido en dwFlags, el controlador debe inicializar el miembro de puntero de función correspondiente de esta estructura. Este miembro puede ser una o varias de las marcas siguientes:

DDHAL_MISC2CB32_CREATESURFACEEX
DDHAL_MISC2CB32_GETDRIVERSTATE
DDHAL_MISC2CB32_DESTROYDDLOCAL

AlphaBlt

Sin usar y se debe establecer en NULL.

CreateSurfaceEx

Apunta a la implementación D3dCreateSurfaceEx del controlador. Esta devolución de llamada crea una asociación entre una superficie de DirectDraw y un pequeño identificador entero.

GetDriverState

Apunta a la implementación D3dGetDriverState del controlador.

DestroyDDLocal

Apunta a la implementación D3dDestroyDDLocal del controlador. Se usa para destruir la copia local del contexto del dispositivo.