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

  • Статья

Функция pfnCreateNewModeInfo возвращает указатель на структуру D3DKMDT_VIDPN_TARGET_MODE , которую драйвер мини-порта дисплея заполняет перед вызовом pfnAddMode.

Синтаксис

DXGKDDI_VIDPNTARGETMODESET_CREATENEWMODEINFO DxgkddiVidpntargetmodesetCreatenewmodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetCreatenewmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [out] DEREF_OUT_PPD3DKMDT_VIDPN_TARGET_MODE ppNewVidPnTargetModeInfo
)
{...}

Параметры

[in] hVidPnTargetModeSet

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

[out] ppNewVidPnTargetModeInfo

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

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

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

Код возврата Описание
STATUS_SUCCESS Функция выполнена успешно.
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET Дескриптор, предоставленный в hVidPnTargetModeSet, недопустим.

Комментарии

Функция pfnCreateNewModeInfo выделяет структуру D3DKMDT_VIDPN_TARGET_MODE и присваивает ее члену Id только что созданный идентификатор.

После вызова pfnCreateNewModeInfo для получения структуры D3DKMDT_VIDPN_TARGET_MODE необходимо выполнить одно из следующих действий, но не оба:

  • Заполните элемент Info структуры и передайте структуру в pfnAddMode.
  • Освободите структуру, вызвав pfnReleaseModeInfo.
При заполнении структуры D3DKMDT_VIDPN_TARGET_MODE можно перезаписать элемент Id , созданный и заданный pfnCreateNewModeInfo. Однако при перезаписи элемента Id любой D3DKMDT_VIDPN_TARGET_MODE структуры необходимо перезаписать элементы Id всех D3DKMDT_VIDPN_TARGET_MODE структур, полученных из pfnCreateNewModeInfo. Если у вас нет определенной причины для перезаписи элементов Id (например, отслеживания целевых режимов с помощью собственной схемы нумеровки), следует оставить их в соответствии с pfnCreateNewModeInfo.

Тип данных D3DKMDT_HVIDPNTARGETMODESET определен в D3dkmdt.h.

Требования

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

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

D3DKMDT_VIDPN_TARGET_MODE

pfnAddMode

pfnReleaseModeInfo