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

Статья
02/06/2025

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

Синтаксис

DXGKDDI_MONITORSOURCEMODESET_ADDMODE DxgkddiMonitorsourcemodesetAddmode;

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

Параметры

[in] hMonitorSourceModeSet

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

[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—предпочтения> равны D3DKMDT_MP_PREFERRED, то новый добавленный режим становится предпочтительным режимом набора режимов.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
целевая платформа	Настольный
заголовка	d3dkmddi.h (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL

См. также

pfnCreateNewModeInfo

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