IDirectDraw::SetDisplayMode (Compact 2013)

3/26/2014

This method sets the mode of the display-device hardware.


HRESULT SetDisplayMode(
  DWORD dwWidth, 
  DWORD dwHeight, 
  DWORD dwBPP, 
  DWORD dwRefreshRate, 
  DWORD dwFlags
); 

dwWidth

Width of the new mode.

dwHeight

Height of the new mode.

dwBPP

Bits per pixel (bpp) of the new mode.

dwRefreshRate

Refresh rate of the new mode. Set this value to 0 to request the default refresh rate for the driver.

dwFlags

No additional flags are currently supported. This parameter must be set to 0.

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_GENERIC

DDERR_INVALIDMODE

DDERR_INVALIDOBJECT

DDERR_INVALIDPARAMS

DDERR_LOCKEDSURFACES

DDERR_SURFACEBUSY

DDERR_UNSUPPORTED

DDERR_WASSTILLDRAWING

For more information on these error codes see DirectDraw Return Values.

As Windows Embedded Compact does not support display mode changes, DDERR_INVALIDMODE will be returned if any mode other than the current one is passed to SetDisplayMode.

Windows Embedded Compact does not support DDSDM_STANDARDVGAMODE.

Header

ddraw.h

Library

ddraw.lib

Show: