Compartilhar via

Método IDirectDraw7::SetDisplayMode (ddraw.h)

  • Artigo

Define o modo do hardware do dispositivo de exibição.

Sintaxe

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

Parâmetros

[in] unnamedParam1

Largura do novo modo de exibição.

[in] unnamedParam2

Altura do novo modo de exibição.

[in] unnamedParam3

Bits por pixel (bpp) do novo modo de exibição.

[in] unnamedParam4

Taxa de atualização do novo modo de exibição. Defina esse valor como 0 para solicitar a taxa de atualização padrão para o driver.

[in] unnamedParam5

Esse valor consiste em sinalizadores que descrevem opções adicionais. Atualmente, o único sinalizador válido é DDSDM_STANDARDVGAMODE, o que faz com que o método defina o Modo 13, em vez do modo X 320x200x8. Se você estiver definindo outra resolução, profundidade de bit ou modo X, não use esse sinalizador; Em vez disso, defina o parâmetro como 0.

Valor retornado

Se o método for bem-sucedido, o valor retornado será DD_OK.

Se falhar, o método poderá retornar um dos seguintes valores de erro:

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

Comentários

Esse método deve ser chamado pelo mesmo thread que criou a janela do aplicativo.

Se outro aplicativo alterar o modo de exibição, a superfície primária será perdida e o método retornará DDERR_SURFACELOST até que a superfície primária seja recriada para corresponder ao novo modo de exibição.

Como parte da interface IDirectDraw da versão anterior, esse método não incluiu os parâmetros dwRefreshRate e dwFlags .

Requisitos

   
Plataforma de Destino Windows
Cabeçalho ddraw.h
Biblioteca Ddraw.lib
DLL Ddraw.dll

Confira também

IDirectDraw7