HRESULT SetDisplayMode (DWORD dwWidth, DWORD dwHeight,
DWORD dwBPP, DWORD dwRefreshRate, DWORD dwFlags);
Устанавливает режим аппаратных средств устройства дисплея.
Возвращает DD_OK если успешно, или одно из следующих значений ошибки:
DDERR_GENERIC DDERR_INVALIDMODE
DDERR_INVALIDOBJECT DDERR_INVALIDPARAMS
DDERR_LOCKEDSURFACES DDERR_NOEXCLUSIVEMODE
DDERR_SURFACEBUSY DDERR_UNSUPPORTED
DDERR_UNSUPPORTEDMODE DDERR_WASSTILLDRAWING
dwWidth
Определяет ширину нового режима.
dwHeight
Определяет высоту нового режима.
dwBPP
Определяет биты на пиксель нового режима.
dwRefreshRate
Определяет частоту регенерации нового режима. Если этот параметр установлен в 0, используется версия интерфейса IDirectDraw этого метода.
dwFlags
Этот параметр в настоящее время не используется и должен быть установлен в 0.
Должен использоваться метод IDirectDraw:: SetCooperativeLevel , чтобы установить исключительный доступ уровня прежде, чем изменять режим. Если другие прикладные программы создали объект DirectDrawSurface на основной поверхности, и режим изменен, основные поверхностные объекты тех прикладных программ возвратят DDERR_SURFACELOST.
Чтобы гарантировать совместимость с COM , этот метод - не, часть интерфейса IDirectDraw, но принадлежит интерфейсу IDirectDraw2. Чтобы использовать этот метод, Вы должны сначала сделать запрос для интерфейса IDirectDraw2. Для большего количества информации, см. Интерфейс IDirectDraw2.
См. также IDirectDraw:: RestoreDisplayMode, IDirectDraw:: GetDisplayMode, IDirectDraw2:: EnumDisplayModes, IDirectDraw:: SetCooperativeLevel