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


функция обратного вызова 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 (include D3dkmddi.h)
IRQL PASSIVE_LEVEL

См. также

D3DKMDT_VIDPN_PRESENT_PATH

pfnAcqirePathInfo

pfnAcquireFirstPathInfo

pfnAcquireNextPathInfo