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