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