функция обратного вызова 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