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

Статья
02/06/2025

Функция pfnGetNumPathsFromSource возвращает количество присутствующих видео путей, содержащих указанный источник видео.

Синтаксис

DXGKDDI_VIDPNTOPOLOGY_GETNUMPATHSFROMSOURCE DxgkddiVidpntopologyGetnumpathsfromsource;

NTSTATUS DxgkddiVidpntopologyGetnumpathsfromsource(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [out] OUT_PSIZE_T pNumPathsFromSource
)
{...}

Параметры

[in] hVidPnTopology

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

[in] VidPnSourceId

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

[out] pNumPathsFromSource

Указатель на переменную типа SIZE_T, которая получает количество путей, содержащих указанный источник.

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

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

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

Замечания

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

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

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

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

Требования

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

См. также

pfnGetNumPaths

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