функция обратного вызова 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 возвращает одно из следующих значений:

Замечания

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

Вызовите 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.

Требования

См. также

D3DKMDT_VIDPN_PRESENT_PATH

pfnCreateNewPathInfo

pfnReleasePathInfo