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

Функция pfnGetTopology возвращает дескриптор объекта топологии VidPN, содержащегося в указанном объекте VidPN.

Синтаксис

DXGKDDI_VIDPN_GETTOPOLOGY DxgkddiVidpnGettopology;

NTSTATUS DxgkddiVidpnGettopology(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [out] OUT_PD3DKMDT_HVIDPNTOPOLOGY phVidPnTopology,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNTOPOLOGY_INTERFACE ppVidPnTopologyInterface
)
{...}

Параметры

[in] hVidPn

Дескриптор объекта VidPN. Диспетчер VidPN ранее предоставлял этот дескриптор драйверу мини-порта дисплея, вызвав DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn или DxgkDdiRecommendFunctionalVidPn.

[out] phVidPnTopology

Указатель на переменную, которая получает дескриптор объекта топологии VidPN.

[out] ppVidPnTopologyInterface

Указатель на переменную, получающую указатель на структуру DXGK_VIDPNTOPOLOGY_INTERFACE . Структура содержит указатели на функции, которые драйвер мини-порта отображения может вызывать для проверки и изменения объекта топологии VidPN.

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

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

Комментарии

Драйверу мини-порта дисплея не нужно освобождать дескриптор, который он получает в phVidPnTopology.

Время существования структуры DXGK_VIDPNTOPOLOGY_INTERFACE, возвращаемой в ppVidPnTopologyInterface , принадлежит операционной системе. Используя эту схему владения, операционная система может переходить на более новые реализации во время выполнения, не нарушая работу клиентов интерфейса.

Требования

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

DXGK_VIDPNTOPOLOGY_INTERFACE

Интерфейс топологии VidPN