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

  • Статья

Функция 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 (включая D3dkmddi.h)
IRQL PASSIVE_LEVEL

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

D3DKMDT_VIDPN_PRESENT_PATH

pfnAcqirePathInfo

pfnAcquireFirstPathInfo

pfnAcquireNextPathInfo