IDirectDraw4::SetDisplayMode (Windows CE 5.0)

Send Feedback

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

HRESULT SetDisplayMode(DWORD dwWidth, DWORD dwHeight, DWORD dwBPP, DWORDdwRefreshRate, DWORDdwFlags);

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:

DDERR_GENERIC
DDERR_INVALIDMODE
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_LOCKEDSURFACES
DDERR_NOEXCLUSIVEMODE
DDERR_SURFACEBUSY
DDERR_UNSUPPORTED
DDERR_UNSUPPORTEDMODE
DDERR_WASSTILLDRAWING

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

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.