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

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

Синтаксис

DXGKDDI_VIDPNTOPOLOGY_ENUMPATHTARGETSFROMSOURCE DxgkddiVidpntopologyEnumpathtargetsfromsource;

NTSTATUS DxgkddiVidpntopologyEnumpathtargetsfromsource(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [in]  IN_CONST_D3DKMDT_VIDPN_PRESENT_PATH_INDEX VidPnPresentPathIndex,
  [out] OUT_PD3DDDI_VIDEO_PRESENT_TARGET_ID pVidPnTargetId
)
{...}

Параметры

[in] hVidPnTopology

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

[in] VidPnSourceId

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

[in] VidPnPresentPathIndex

Отсчитываемый от нуля индекс в набор путей, содержащих источник, определенный VidPnSourceId.

[out] pVidPnTargetId

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

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

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

Замечания

VidPnPresentPathIndex не является индексом всех путей в топологии, определяемой hVidPnTopology. Это индекс в подмножество всех путей в топологии: в частности, подмножество всех путей, содержащих источник, определенный VidPnSourceId.

Чтобы перечислить (в данной топологии) все целевые объекты, связанные с определенным источником, выполните следующие действия.

Вызовите pfnGetNumPathsFromSource, чтобы определить число путей, содержащих источник интереса. Думайте об этих путях как индексированные наборы с индексами 0, 1, ... N - 1.

Для каждого индекса 0 хотя N - 1 передайте исходный идентификатор и индекс в pfnEnumPathTargetsFromSource.

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

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

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

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

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

Требования

См. также

pfnGetNumPathsFromSource

pfnGetPathSourceFromTarget