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

  • Статья

Функция pfnAddPath добавляет путь представления видео к указанному объекту топологии VidPN.

Синтаксис

DXGKDDI_VIDPNTOPOLOGY_ADDPATH DxgkddiVidpntopologyAddpath;

NTSTATUS DxgkddiVidpntopologyAddpath(
  [in] IN_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in] IN_PD3DKMDT_VIDPN_PRESENT_PATH pVidPnPresentPath
)
{...}

Параметры

[in] hVidPnTopology

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

[in] pVidPnPresentPath

Указатель на структуру D3DKMDT_VIDPN_PRESENT_PATH, описывающую путь. Драйвер мини-порта дисплея ранее получил этот указатель, вызвав pfnCreateNewPathInfo.

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

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

Код возврата Описание
STATUS_SUCCESS Функция выполнена успешно.
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY Дескриптор, предоставленный в hVidPnTopology, был недопустим.
STATUS_ACCESS_DENIED Невозможно удалить путь в контексте текущего вызова DDI.

Комментарии

Чтобы добавить путь к топологии, драйвер мини-порта дисплея выполняет следующие действия.

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

Заполните структуру D3DKMDT_VIDPN_PRESENT_PATH сведениями о пути, включая исходные и целевые идентификаторы видеотрансляции.

Вызовите pfnAddPath , чтобы добавить путь к топологии.

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

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

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

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Целевая платформа Персональный компьютер
Верхняя часть d3dkmddi.h (включая D3dkmddi.h)
IRQL PASSIVE_LEVEL

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

D3DKMDT_VIDPN_PRESENT_PATH

pfnCreateNewPathInfo

pfnReleasePathInfo