Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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