функция обратного вызова 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 |