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

Статья
02/06/2025

Функция pfnCreateNewPathInfo возвращает указатель на структуру D3DKMDT_VIDPN_PRESENT_PATH, заполненную драйвером мини-порта отображения перед вызовом pfnAddPath.

Синтаксис

DXGKDDI_VIDPNTOPOLOGY_CREATENEWPATHINFO DxgkddiVidpntopologyCreatenewpathinfo;

NTSTATUS DxgkddiVidpntopologyCreatenewpathinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [out] DEREF_OUT_PPD3DKMDT_VIDPN_PRESENT_PATH ppNewVidPnPresentPathInfo
)
{...}

Параметры

[in] hVidPnTopology

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

[out] ppNewVidPnPresentPathInfo

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

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

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

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

Замечания

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

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

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

Требования

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

См. также

D3DKMDT_VIDPN_PRESENT_PATH

pfnAddPath

pfnReleasePathInfo

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