Метод IDirectDraw7::EnumDisplayModes (ddraw.h)

Статья
03/14/2023

Перечисляет все режимы отображения, предоставляемые оборудованием через объект DirectDraw и совместимые с предоставленным описанием поверхности.

Синтаксис

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

Параметры

[in] unnamedParam1

Это значение состоит из одного или нескольких следующих флагов:

DDEDM_REFRESHRATES

Перечисляет режимы с разными частотами обновления. IDirectDraw7::EnumDisplayModes гарантирует, что определенный режим перечисляется только один раз. Этот флаг указывает, учитывается ли частота обновления при определении уникальности режима.

DDEDM_STANDARDVGAMODES

Перечисляет режим 13 в дополнение к режиму X 320x200x8.

[in] unnamedParam2

Адрес структуры DDSURFACEDESC2 для проверки на соответствие доступным режимам. Если значение этого параметра равно NULL, перечисляются все режимы.

[in] unnamedParam3

Адрес определяемой приложением структуры, передаваемой каждому элементу перечисления.

[in] unnamedParam4

Адрес функции EnumModesCallback2 , которую процедура перечисления вызывает при каждом обнаружении совпадения.

Возвращаемое значение

Если метод выполнен успешно, возвращаемое значение будет DD_OK.

В случае сбоя метод может вернуть одно из следующих значений ошибки:

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS

IDirectDraw7::EnumDisplayModes перечисляет элемент dwRefreshRate структуры DDSURFACEDESC2 ; Метод IDirectDraw::EnumDisplayModes не имеет такой возможности. Если вы используете метод IDirectDraw7::SetDisplayMode , чтобы задать частоту обновления нового режима, используйте IDirectDraw7::EnumDisplayModes для перечисления элемента dwRefreshRate .

IDirectDraw7::EnumDisplayModes отличается от своих аналогов в предыдущих интерфейсах тем, что принимает адрес функции EnumModesCallback2 в качестве параметра, а не функции EnumModesCallback .

Требования


Целевая платформа	Windows
Header	ddraw.h
Библиотека	Ddraw.lib
DLL	Ddraw.dll

См. также раздел

IDirectDraw7

Поделиться через