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

Статья
02/06/2025

Функция pfnReleasePathInfo выпускает структуру D3DKMDT_VIDPN_PRESENT_PATH, которую ранее предоставил диспетчеру VidPN для драйвера минипорта отображения.

Синтаксис

DXGKDDI_VIDPNTOPOLOGY_RELEASEPATHINFO DxgkddiVidpntopologyReleasepathinfo;

NTSTATUS DxgkddiVidpntopologyReleasepathinfo(
  [in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in] IN_CONST_PD3DKMDT_VIDPN_PRESENT_PATH_CONST pVidPnPresentPathInfo
)
{...}

Параметры

[in] hVidPnTopology

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

[in] pVidPnPresentPathInfo

Указатель на D3DKMDT_VIDPN_PRESENT_PATH структуру, которую необходимо освободить.

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

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

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

Замечания

Завершив использование структуры D3DKMDT_VIDPN_PRESENT_PATH, полученной путем вызова любой из следующих функций, необходимо освободить структуру, вызвав pfnReleasePathInfo.

Если вы получите структуру D3DKMDT_VIDPN_PRESENT_PATH путем вызова pfnCreateNewPathInfo, а затем передайте эту структуру в pfnAddPath, вам не нужно освободить структуру.

Если вы получите дескриптор путем вызова pfnCreateNewPathInfo, а затем вы решили не добавить новый путь к топологии, необходимо освободить только что созданную структуру, вызвав pfnReleasePathInfo.

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

Требования

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

См. также

D3DKMDT_VIDPN_PRESENT_PATH

pfnAcqirePathInfo

pfnAcquireFirstPathInfo

pfnAcquireNextPathInfo

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