IDirectDraw4::SetDisplayMode

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

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

Parameters

• 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.

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:

Remarks

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

Windows CE does not support DDSDM_STANDARDVGAMODE.

Requirements

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header: Ddraw.h.
Link Library: Ddraw.lib.

See Also

IDirectDraw4::RestoreDisplayMode | IDirectDraw4::GetDisplayMode | IDirectDraw4::EnumDisplayModes | IDirectDraw4::SetCooperativeLevel

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.