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