ChangeDisplaySettingsEx

9/9/2008

Essa função altera as configurações do dispositivo especificado exibir para o modo gráfico especificado.

Syntax

LONG ChangeDisplaySettingsEx(
  LPCTSTR lpszDeviceName,
  LPDEVMODE lpDevMode,
  HWND hwnd,
  DWORD dwflags,
  LPVOID lParam
);

Parameters

• lpszDeviceName
  [no] Não usado. Definir como NULL.

• lpDevMode
  [in, Out] Ponteiro para um DEVMODE estrutura que descreve o novo modo de elementos gráficos.

  Se lpDevMode é NULL, ChangeDisplaySettingsEx usa todos os valores atualmente no Registro para a configuração exibir.

  Passando NULL para a lpDevMode parâmetro e 0 para o dwFlags parâmetro é a maneira mais fácil para retornar para o modo padrão após um dinâmico alteração modo.

  Você deve inicializar a dmSize membro das DEVMODE estrutura com o tamanho, em bytes, da estrutura. A seguinte tabela mostra os membros a DEVMODE estrutura que você pode usar.

  Valor	Descrição
  dmPelsWidth	For Windows Embedded CE: Windows Embedded CE 6.0 e versões posteriores, esse valor indica largura pixel.
  dmPelsHeight	For Windows Embedded CE: Windows Embedded CE 6.0 e versões posteriores, esse valor indica altura pixel.
  dmDisplayOrientation	Rotação Tela. Rotação Tela não é com suporte em plataformas com múltiplo telas.

  Configurando o dmBitsPerPel membro não é com suporte.

  A seguinte tabela mostra os valores na dmFields membro que você também deve definir a alteração no além exibir as configurações usando um ou mais da acima, DEVMODE Os membros.

  Valor	Descrição
  DM_DISPLAYQUERYORIENTATION	Verifique se o driver exibir oferece suporte à rotação Tela. O com suporte Tela orientações são retornadas lpDevMode.dmDisplayOrientation. Um valor de apenas DMO_0 indica que a rotação Tela não é com suporte.
  DM_DISPLAYORIENTATION	Use o dmDisplayOrientation valor a alteração a orientação da Tela.
  DM_PELSWIDTH	For Windows Embedded CE: Windows Embedded CE 6.0 e versões posteriores, esse valor indica ao usar o dmPelsWidth valor.
  DM_PELSHEIGHT	For Windows Embedded CE: Windows Embedded CE 6.0 e versões posteriores, esse valor indica ao usar o dmPelsHeight valor.

  Para garantir que o DEVMODE estrutura passado para ChangeDisplaySettingsEx é válido e contém apenas valores com suporte pelo driver de exibir, usar o DEVMODE retornado pelo EnumDisplaySettings função.

• hwnd
  [no] Reservado; deve ser NULL.

• dwFlags
  [no] DWORD que indica como você desejar para alteração de modo de elementos gráficos. A seguinte tabela mostra os valores possíveis.

  Valor	Descrição
  0	Altera o modo gráfico para a atual Tela dinamicamente.
  CDS_RESET	Altera as configurações, mesmo se as configurações solicitadas são os mesmos que a atual Configurações.
  CDS_TEST	Testa se ChangeDisplaySettingsEx Pode definir o modo gráfico solicitada. Especificando CDS_TEST permite que um aplicativo para determinar quais modos gráficos são realmente válido, sem fazendo com que o sistema a alteração para as configurações.
  CDS_VIDEOPARAMETERS	Indica que o lParam parâmetro é um ponteiro para um VIDEOPARAMETERS estrutura.

• lParam
  [no] Ponteiro para um VIDEOPARAMETERS estrutura se dwFlags é CDS_VIDEOPARAMETERS. Caso contrário, definir a NULL.

Return Value

A seguinte tabela mostra os possíveis valores de retorno.

Valor	Descrição
DISP_CHANGE_SUCCESSFUL	A alteração configurações foi bem-sucedido.
DISP_CHANGE_BADFLAGS	Um inválido foi usado em conjunto de valores de dwFlags parâmetro.
DISP_CHANGE_BADMODE	O modo de elementos gráficos não é com suporte.
DISP_CHANGE_BADPARAM	Um inválido parâmetro foi usado. Este erro pode incluir um valor inválido ou uma combinação de valores.
DISP_CHANGE_FAILED	Falha de driver exibir o modo gráfico especificado.
DISP_CHANGE_NOTUPDATED	ChangeDisplaySettingsEx pôde gravar as configurações para o Registro.
DISP_CHANGE_RESTART	O usuário deve reiniciar o computador para o modo de elementos gráficos para trabalho.

Remarks

Quando você alteração a modo de exibição dinamicamente, o OS envia o WM_SETTINGCHANGE mensagem para execução todos os aplicativos.

A consulta para o atual orientação, chamar ChangeDisplaySettingsEx Com lpDevMode Definir como DM_DISPLAYORIENTATION e dwFlags Defina como CDS_TEST. O atual orientação será retornada em lpDevMode.

A seguinte tabela mostra o valor dos parâmetros que usa o OS quando ele envia esta mensagem.

Parâmetro	Valor
wParam	SETTINGCHANGE_RESET
lParam	0

Usando o sinalizador dmFields de DM_DISPLAYORIENTATION, ChangeDisplaySettingsEx pode ser usado para girar a orientação Tela dinamicamente. Windows CE 5.0 e versões anteriores, os sinalizadores DM_PELSWIDTH e DM_PELSHEIGHT não podem ser usados para alteração de resolução Tela.

Requirements

Header	windows.h
Library	coredll.lib
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

CreateDC
DEVMODE
EnumDisplaySettings