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

  • Статья

Функция 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, реализованный драйвером мини-порта дисплея, возвращает число N источников видеотрансляции, поддерживаемых видеоадаптером. Затем операционная система назначает идентификаторы 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 (включая D3dkmddi.h)
IRQL PASSIVE_LEVEL

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

pfnEnumPathTargetsFromSource