通过

IDirectDraw7：：SetDisplayMode 方法 (ddraw.h)

  • 项目

设置显示设备硬件的模式。

语法

HRESULT SetDisplayMode(
  [in] DWORD unnamedParam1,
  [in] DWORD unnamedParam2,
  [in] DWORD unnamedParam3,
  [in] DWORD unnamedParam4,
  [in] DWORD unnamedParam5
);

参数

[in] unnamedParam1

新显示模式的宽度。

[in] unnamedParam2

新显示模式的高度。

[in] unnamedParam3

新显示模式的每像素 (bpp) 位数。

[in] unnamedParam4

新显示模式的刷新率。 将此值设置为 0 可请求驱动程序的默认刷新率。

[in] unnamedParam5

此值由描述其他选项的标志组成。 目前，唯一有效的标志是 DDSDM_STANDARDVGAMODE，这会导致方法设置 Mode 13，而不是 Mode X 320x200x8 模式。 如果要设置其他分辨率、位深度或模式 X 模式，请不要使用此标志;而是将 参数设置为 0。

返回值

如果该方法成功，则返回值DD_OK。

如果失败，该方法可能会返回以下错误值之一：

  • DDERR_GENERIC
  • DDERR_INVALIDMODE
  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_LOCKEDSURFACES
  • DDERR_NOEXCLUSIVEMODE
  • DDERR_SURFACEBUSY
  • DDERR_UNSUPPORTED
  • DDERR_UNSUPPORTEDMODE
  • DDERR_WASSTILLDRAWING

备注

此方法必须由创建应用程序窗口的同一线程调用。

如果另一个应用程序更改了显示模式，则主图面将丢失，并且该方法将返回DDERR_SURFACELOST，直到重新创建主图面以匹配新的显示模式。

作为早期版本的 IDirectDraw 接口的一部分，此方法不包括 dwRefreshRate 和 dwFlags 参数。

要求

   
目标平台 Windows
标头 ddraw.h
Library Ddraw.lib
DLL Ddraw.dll

请参阅

IDirectDraw7