функция обратного вызова 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 возвращает одно из следующих значений:

Код возврата Описание
STATUS_SUCCESS Функция выполнена успешно.
STATUS_GRAPHICS_INVALID_VIDPN Дескриптор, предоставленный в hVidPn, был недопустимым.

Комментарии

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

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

Требования

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

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

DXGK_VIDPNTOPOLOGY_INTERFACE

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