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

Функция D3DKMTSetDisplayMode (d3dkmthk.h)

  • Статья

Функция D3DKMTSetDisplayMode задает выделение, используемое для сканирования на дисплее.

Синтаксис

NTSTATUS D3DKMTSetDisplayMode(
  [in, out] const D3DKMT_SETDISPLAYMODE *unnamedParam1
);

Параметры

[in, out] unnamedParam1

Указатель на структуру D3DKMT_SETDISPLAYMODE , описывающую выделение, используемое для сканирования.

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

D3DKMTSetDisplayMode возвращает одно из следующих значений:

Код возврата Описание
STATUS_SUCCESS Режим отображения успешно настроен.
STATUS_DEVICE_REMOVED Графический адаптер остановлен или устройство отображения было сброшено.
STATUS_INVALID_PARAMETER Параметры были проверены и определены как неверные.
STATUS_GRAPHICS_NOT_EXCLUSIVE_MODE_OWNER До вызова D3DKMTSetDisplayMode устройство не приобрело монопольного владения представлением. Поэтому устройству не удалось установить режим отображения.
D3DDDIERR_INCOMPATIBLEPRIVATEFORMAT Установленный клиентский драйвер OpenGL (ICD) должен преобразовать формат поверхности, связанной с выделением, указанным элементом hPrimaryAllocationD3DKMT_SETDISPLAYMODE , в атрибут format, который указывает член PrivateDriverFormatAttributeD3DKMT_SETDISPLAYMODE . Затем ICD должен снова вызвать D3DKMTSetDisplayMode . ICD может выделить новое выделение, выполнить преобразование битового блока передачи (bitblt) из старого источника в новый, а затем уничтожить старый источник, если ICD использует новый дескриптор выделения для этого выделения для всех последующих операций. ICD должен повторять этот процесс, пока D3DKMTSetDisplayMode не вернет другое возвращаемое значение.

Эта функция также может возвращать другие значения NTSTATUS .

Комментарии

Прежде чем OpenGL ICD вызовет D3DKMTSetDisplayMode для установки нового режима отображения, использующего расширенный формат, метод множественной выборки или и то, и другое, ICD должен убедиться, что текущий режим отображения GDI имеет то же разрешение, что и новый режим отображения. В противном случае D3DKMTSetDisplayMode возвращает STATUS_INVALID_PARAMETER.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Целевая платформа Универсальное
Верхняя часть d3dkmthk.h (включая D3dkmthk.h)
Библиотека Gdi32.lib
DLL Gdi32.dll

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

D3DKMT_SETDISPLAYMODE