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

Статья
02/06/2025

Функция pfnGetPathSourceFromTarget возвращает идентификатор источника представления видео, связанного с указанным целевым объектом видео.

Синтаксис

DXGKDDI_VIDPNTOPOLOGY_GETPATHSOURCEFROMTARGET DxgkddiVidpntopologyGetpathsourcefromtarget;

NTSTATUS DxgkddiVidpntopologyGetpathsourcefromtarget(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidTopology,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [out] OUT_PD3DDDI_VIDEO_PRESENT_SOURCE_ID pVidPnSourceId
)
{...}

Параметры

[in] hVidTopology

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

[in] VidPnTargetId

Целое число, определяющее конкретный источник видео.

[out] pVidPnSourceId

Указатель на переменную, которая получает идентификатор источника видео.

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

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

Возвращаемый код	Описание
STATUS_SUCCESS	Функция завершилась успешно.
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY	Дескриптор, предоставленный в hVidPnTopology, недопустим.
STATUS_INVALID_PARAMETER	Указатель, предоставленный в pVidPnSourceId, был допустимым.

Замечания

Топология — это пути к коллекции, каждая из которых содержит пару (источник, целевой объект). Определенный целевой объект принадлежит по крайней мере одному пути, поэтому при указании идентификатора целевого объекта существует не более одного источника, связанного с этим целевым объектом.

Идентификаторы источника VidPN назначаются операционной системой. DxgkDdiStartDevice, реализованной драйвером минипорта дисплея, возвращает количество источников видео, поддерживаемых адаптером отображения. Затем операционная система назначает идентификаторы 0, 1, 2, ... N - 1.

Целевые идентификаторы VidPN назначаются драйвером мини-порта отображения. DxgkDdiQueryChildRelations, реализованный драйвером мини-порта отображения, возвращает массив структур DXGK_CHILD_DESCRIPTOR, каждый из которых содержит идентификатор.

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

Типы данных D3DDDI_VIDEO_PRESENT_SOURCE_ID D3DDDI_VIDEO_PRESENT_TARGET_ID определены в D3dukmdt.h.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
целевая платформа	Настольный
заголовка	d3dkmddi.h (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL

См. также

pfnEnumPathTargetsFromSource

Поделиться через