Compartir a través de

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

  • Artículo

Enumera todos los modos de presentación que expone el hardware a través del objeto DirectDraw y que son compatibles con una descripción de superficie proporcionada.

Sintaxis

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

Parámetros

[in] unnamedParam1

Este valor consta de una o varias de las marcas siguientes:

DDEDM_REFRESHRATES

Enumera los modos con diferentes velocidades de actualización. IDirectDraw7::EnumDisplayModes garantiza que un modo determinado se enumera solo una vez. Esta marca especifica si la frecuencia de actualización se tiene en cuenta al determinar si un modo es único.

DDEDM_STANDARDVGAMODES

Enumera el modo 13 además del modo X de 320x200x8.

[in] unnamedParam2

Dirección de una estructura DDSURFACEDESC2 que se va a comprobar con los modos disponibles. Si el valor de este parámetro es NULL, se enumeran todos los modos.

[in] unnamedParam3

Dirección de una estructura definida por la aplicación que se va a pasar a cada miembro de enumeración.

[in] unnamedParam4

Dirección de la función EnumModesCallback2 a la que llama el procedimiento de enumeración cada vez que se encuentra una coincidencia.

Valor devuelto

Si el método se realiza correctamente, el valor devuelto es DD_OK.

Si se produce un error, el método puede devolver uno de los siguientes valores de error:

  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS

Comentarios

IDirectDraw7::EnumDisplayModes enumera el miembro dwRefreshRate de la estructura DDSURFACEDESC2 ; El método IDirectDraw::EnumDisplayModes no tiene esta capacidad. Si usas el método IDirectDraw7::SetDisplayMode para establecer la frecuencia de actualización de un nuevo modo, usa IDirectDraw7::EnumDisplayModes para enumerar el miembro dwRefreshRate .

IDirectDraw7::EnumDisplayModes difiere de sus homólogos en las interfaces anteriores en que acepta la dirección de una función EnumModesCallback2 como parámetro, en lugar de una función EnumModesCallback .

Requisitos

   
Plataforma de destino Windows
Encabezado ddraw.h
Library Ddraw.lib
Archivo DLL Ddraw.dll

Consulte también

IDirectDraw7