Edit

Share via

DD_COLORCONTROLDATA structure (ddrawint.h)

  • Article

The DD_COLORCONTROLDATA structure contains the color control information for the specified overlay.

Syntax

typedef struct _DD_COLORCONTROLDATA {
  PDD_DIRECTDRAW_GLOBAL lpDD;
  PDD_SURFACE_LOCAL     lpDDSurface;
  LPDDCOLORCONTROL      lpColorData;
  DWORD                 dwFlags;
  HRESULT               ddRVal;
  VOID                  *ColorControl;
} *PDD_COLORCONTROLDATA, DD_COLORCONTROLDATA;

Members

lpDD

Points to a DD_DIRECTDRAW_GLOBAL structure that describes the driver's device.

lpDDSurface

Points to the DD_SURFACE_LOCAL structure representing the overlay surface.

lpColorData

Points to a DDCOLORCONTROL structure. See the dwFlags member to determine how to use this member.

dwFlags

Indicates a set of flags that specify the color control flags. This member can be one of the following values:

Flag Meaning
DDRAWI_GETCOLOR The driver should return the color controls it supports for the specified overlay in the lpColorData member. The driver should set the appropriate flags in the dwFlags member of the DDCOLORCONTROL structure to indicate in which other members the driver has returned valid data.
DDRAWI_SETCOLOR The driver should set the current color controls for the specified overlay using the values specified in the lpColorData member.

ddRVal

Specifies the location in which the driver writes the return value of the DdControlColor callback. A return code of DD_OK indicates success. For more information, see Return Values for DirectDraw.

ColorControl

Used by the Microsoft DirectDraw API and should not be filled in by the driver.

Requirements

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

See also

DdControlColor