IDirectDrawColorControl::GetColorControls

The IDirectDrawColorControl::GetColorControls method returns the current color control settings associated with the specified overlay or primary surface. The dwFlags member of the DDCOLORCONTROL structure indicates which of the color control options are supported.

HRESULT GetColorControls(
  LPDDCOLORCONTROL lpColorControl  
);

Parameters

lpColorControl
Address of the DDCOLORCONTROL structure that will receive the current control settings of the specified surface.

Return Values

If the method succeeds, the return value is DD_OK.

If the method fails, the return value may be one of the following error values:

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_UNSUPPORTED

QuickInfo

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in ddraw.h.
  Import Library: Use ddraw.lib.

See Also

IDirectDrawColorControl::SetColorControls, Using Color Controls, Gamma and Color Controls