Edit

DD_NTCALLBACKS structure (ddrawint.h)

  • Article

The DD_NTCALLBACKS structure contains entry pointers to Microsoft Windows 2000 and later Microsoft DirectDraw callback functions that a device driver supports.

Syntax

typedef struct _DD_NTCALLBACKS {
  DWORD                dwSize;
  DWORD                dwFlags;
  PDD_FREEDRIVERMEMORY FreeDriverMemory;
  PDD_SETEXCLUSIVEMODE SetExclusiveMode;
  PDD_FLIPTOGDISURFACE FlipToGDISurface;
} DD_NTCALLBACKS, *PDD_NTCALLBACKS;

Members

dwSize

Specifies the size in bytes of this DD_NTCALLBACKS structure.

dwFlags

Indicates what Windows 2000 and later callback functions the driver has 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_NTCB32_FREEDRIVERMEMORY
DDHAL_NTCB32_SETEXCLUSIVEMODE
DDHAL_NTCB32_FLIPTOGDISURFACE

FreeDriverMemory

Points to the driver-supplied DdFreeDriverMemory callback.

SetExclusiveMode

Points to the driver-supplied DdSetExclusiveMode callback.

FlipToGDISurface

Points to the driver-supplied DdFlipToGDISurface callback.

Remarks

Entries that the display driver does not use should be set to NULL. The driver should initialize this structure when its DdGetDriverInfo function is called with the GUID_NTCallbacks GUID.

Requirements

Requirement Value
Header ddrawint.h (include Winddi.h)

See also

DD_COLORCONTROLCALLBACKS

DD_KERNELCALLBACKS

DD_MISCELLANEOUSCALLBACKS

DD_MOTIONCOMPCALLBACKS

DD_PALETTECALLBACKS

DD_SURFACECALLBACKS

DD_VIDEOPORTCALLBACKS

DdFlipToGDISurface

DdFreeDriverMemory

DdGetDriverInfo

DdSetExclusiveMode