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

Статья
02/06/2025

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

Синтаксис

DXGKDDI_VIDPNSOURCEMODESET_CREATENEWMODEINFO DxgkddiVidpnsourcemodesetCreatenewmodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetCreatenewmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [out] DEREF_OUT_PPD3DKMDT_VIDPN_SOURCE_MODE ppNewVidPnSourceModeInfo
)
{...}

Параметры

[in] hVidPnSourceModeSet

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

[out] ppNewVidPnSourceModeInfo

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

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

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

Возвращаемый код	Описание
STATUS_SUCCESS	Функция завершилась успешно.
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET	Дескриптор, предоставленный в hVidPnSourceModeSet, был недопустим.

Замечания

Функция pfnCreateNewModeInfo выделяет структуру D3DKMDT_VIDPN_SOURCE_MODE, задает элемент идентификатора для нового созданного идентификатора и задает для элемента тип значение D3DKMDT_RMT_UNINITIALIZED.

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

Заполните структуру и передайте ее в pfnAddMode.
Отпустите структуру, вызвав pfnReleaseModeInfo.

При заполнении структуры D3DKMDT_VIDPN_SOURCE_MODE у вас есть возможность перезаписи элемента идентификатора, который был создан и задан pfnCreateNewModeInfo. Однако если перезаписать элемент идентификатора любой D3DKMDT_VIDPN_SOURCE_MODE структуры, необходимо перезаписать элементы идентификатора всех D3DKMDT_VIDPN_SOURCE_MODE структур, полученных из pfnCreateNewModeInfo. Если у вас нет определенной причины перезаписи элементов id (например, отслеживания режимов источника с помощью собственной схемы нумерации), их следует оставить как задано pfnCreateNewModeInfo.

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

Требования

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

См. также

D3DKMDT_VIDPN_SOURCE_MODE

pfnAddMode

pfnReleaseModeInfo

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