функция обратного вызова DXGKDDI_MONITORSOURCEMODESET_ADDMODE (d3dkmddi.h)

  • Статья

Функция pfnAddMode добавляет режим источника монитора к указанному объекту набора исходного режима монитора.

Синтаксис

DXGKDDI_MONITORSOURCEMODESET_ADDMODE DxgkddiMonitorsourcemodesetAddmode;

NTSTATUS DxgkddiMonitorsourcemodesetAddmode(
  [in] IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
  [in] IN_PD3DKMDT_MONITOR_SOURCE_MODE_CONST pMonitorSourceModeInfo
)
{...}

Параметры

[in] hMonitorSourceModeSet

Дескриптор объекта набора исходного режима мониторинга. Драйвер мини-порта дисплея ранее получил этот дескриптор, вызвав функцию pfnAcquireMonitorSourceModeSetинтерфейса Monitor.

[in] pMonitorSourceModeInfo

Указатель на структуру D3DKMDT_MONITOR_SOURCE_MODE , описывающую режим источника монитора. Драйвер мини-порта дисплея ранее получил эту структуру, вызвав pfnCreateNewModeInfo.

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

Функция pfnAddMode возвращает одно из следующих значений.

Код возврата Описание
STATUS_SUCCESS Функция выполнена успешно.
STATUS_NO_MEMORY Сбой функции, так как ей не удалось выделить достаточно памяти.
STATUS_GRAPHICS_INVALID_MONITOR_SOURCE_MODE Сведения, предоставленные в pMonitorSourceModeInfo, были недопустимыми.
STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET Дескриптор, предоставленный в hMonitorSourceModeSet, был недопустимым.
STATUS_GRAPHICS_INVALID_FREQUENCY Сведения о частоте, предоставленные в pMonitorSourceModeInfo, были недопустимыми.
STATUS_GRAPHICS_INVALID_ACTIVE_REGION Активная область, указанная в pMonitorSourceModeInfo, была недопустимой.
STATUS_GRAPHICS_INVALID_TOTAL_REGION Общий регион, предоставленный в pMonitorSourceModeInfo, был недопустимым.
STATUS_GRAPHICS_MODE_ALREADY_IN_MODE_SET Набор режимов уже содержит режим, идентичный режиму, предоставленному в pMonitorSourceModeInfo.
STATUS_GRAPHICS_MODE_ID_MUST_BE_UNIQUE Идентификатор, указанный в pMonitorSourceModeInfo-Id>, уже используется для другого режима в наборе режимов.
STATUS_GRAPHICS_RESOURCES_NOT_RELATED Структура, на которую указывает pMonitorSourceModeInfo, не была создана для добавления к набору режимов, заданному hMonitorSourceModeSet.

Комментарии

Если параметр pMonitorSourceModeInfo-Preference> равен D3DKMDT_MP_PREFERRED, добавленный режим становится предпочтительным для набора режимов.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Целевая платформа Персональный компьютер
Верхняя часть d3dkmddi.h (включая D3dkmddi.h)
IRQL PASSIVE_LEVEL

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

pfnCreateNewModeInfo