Compartilhar via

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

  • Artigo

Enumera todos os modos de exibição que o hardware expõe por meio do objeto DirectDraw e que são compatíveis com uma descrição de superfície fornecida.

Sintaxe

HRESULT EnumDisplayModes(
  [in] DWORD                  unnamedParam1,
  [in] LPDDSURFACEDESC2       unnamedParam2,
  [in] LPVOID                 unnamedParam3,
  [in] LPDDENUMMODESCALLBACK2 unnamedParam4
);

Parâmetros

[in] unnamedParam1

Esse valor consiste em um ou mais dos seguintes sinalizadores:

DDEDM_REFRESHRATES

Enumera modos com taxas de atualização diferentes. IDirectDraw7::EnumDisplayModes garante que um modo específico seja enumerado apenas uma vez. Esse sinalizador especifica se a taxa de atualização é levada em conta ao determinar se um modo é exclusivo.

DDEDM_STANDARDVGAMODES

Enumera o Modo 13, além do modo X do modo X 320x200x8.

[in] unnamedParam2

Endereço de uma estrutura DDSURFACEDESC2 a ser verificado em relação aos modos disponíveis. Se o valor desse parâmetro for NULL, todos os modos serão enumerados.

[in] unnamedParam3

Endereço de uma estrutura definida pelo aplicativo a ser passada para cada membro de enumeração.

[in] unnamedParam4

Endereço da função EnumModesCallback2 que o procedimento de enumeração chama sempre que uma correspondência é encontrada.

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_INVALIDOBJECT
  • DDERR_INVALIDPARAMS

Comentários

IDirectDraw7::EnumDisplayModes enumera o membro dwRefreshRate da estrutura DDSURFACEDESC2 ; O método IDirectDraw::EnumDisplayModes não tem essa capacidade. Se você usar o método IDirectDraw7::SetDisplayMode para definir a taxa de atualização de um novo modo, use IDirectDraw7::EnumDisplayModes para enumerar o membro dwRefreshRate .

IDirectDraw7::EnumDisplayModes difere de seus equivalentes em interfaces anteriores, pois aceita o endereço de uma função EnumModesCallback2 como um parâmetro, em vez de uma função EnumModesCallback .

Requisitos

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

Confira também

IDirectDraw7