DD_MISCELLANEOUS2CALLBACKS structure (ddrawint.h)

The DD_MISCELLANEOUS2CALLBACKS structure is used to return the addresses of miscellaneous callback routines. These routines are new for Microsoft DirectX 7.0 and later and are exposed through DdGetDriverInfo by responding to the GUID_Miscellaneous2Callbacks GUID.

Syntax

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

Members

dwSize

Specifies the size, in bytes, of this structure.

dwFlags

Indicates which miscellaneous callback functions the driver implemented. For every bit set in dwFlags, the driver must initialize the corresponding function pointer member of this structure. This member can be one or more of the following flags:

DDHAL_MISC2CB32_CREATESURFACEEX

DDHAL_MISC2CB32_GETDRIVERSTATE

DDHAL_MISC2CB32_DESTROYDDLOCAL

AlphaBlt

Unused and must be set to NULL.

CreateSurfaceEx

Points to the driver's D3dCreateSurfaceEx implementation. This callback creates an association between a DirectDraw surface and a small integer handle.

GetDriverState

Points to the driver's D3dGetDriverState implementation.

DestroyDDLocal

Points to the driver's D3dDestroyDDLocal implementation. Used to destroy the local copy of the device context.

Requirements

See also

D3dCreateSurfaceEx

D3dDestroyDDLocal

D3dGetDriverState

DdGetDriverInfo