Edit

DD_DIRECTDRAW_GLOBAL structure (ddrawint.h)

  • Article

The DD_DIRECTDRAW_GLOBAL structure contains driver information that describes the driver's device.

Syntax

typedef struct _DD_DIRECTDRAW_GLOBAL {
  VOID              *dhpdev;
  ULONG_PTR         dwReserved1;
  ULONG_PTR         dwReserved2;
  LPDDVIDEOPORTCAPS lpDDVideoPortCaps;
} *PDD_DIRECTDRAW_GLOBAL, DD_DIRECTDRAW_GLOBAL;

Members

dhpdev

Handle to the driver's private PDEV.

dwReserved1

Reserved for use by the display driver.

dwReserved2

Reserved for use by the display driver.

lpDDVideoPortCaps

Points to an array of one or more DDVIDEOPORTCAPS structures in which the driver should describe the DirectDraw video port extensions (VPE) objects that it supports. The structures are allocated by DirectDraw; the number of structures is based on the value returned in the dwMaxVideoPort member of DDCORECAPS.

This member is NULL when the driver does not implement the VPE.

Remarks

DirectDraw allocates memory for this structure. Only one DD_DIRECTDRAW_GLOBAL definition exists per device. In a multimonitor system, each device has its own unique DD_DIRECTDRAW_GLOBAL structure.

The dwReserved1 and dwReserved2 members can be used as required by the driver. For example, a driver might store pointers to internal data structures in these members.

Requirements

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

See also

DD_DIRECTDRAW_LOCAL