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

  • Статья

Функция 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, реализованный драйвером мини-порта дисплея, возвращает число N источников видеотрансляции, поддерживаемых видеоадаптером. Затем операционная система назначает идентификаторы 0, 1, 2, ... N - 1.

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

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

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Целевая платформа Персональный компьютер
Верхняя часть d3dkmddi.h (включая D3dkmddi.h)
IRQL PASSIVE_LEVEL

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

pfnGetNumPaths