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

Функция DxgkDdiRecommendVidPnTopology создает топологию указанного VidPN или дополняет топологию новым путем к целевым объектам представления видео.

Синтаксис

DXGKDDI_RECOMMENDVIDPNTOPOLOGY DxgkddiRecommendvidpntopology;

NTSTATUS DxgkddiRecommendvidpntopology(
       IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_RECOMMENDVIDPNTOPOLOGY_CONST pRecommendVidPnTopology
)
{...}

Параметры

hAdapter

Дескриптор для блока контекста, связанного с видеоадаптером. Драйвер мини-порта дисплея ранее предоставлял этот дескриптор подсистеме ядра графики Microsoft DirectX в выходном параметре MiniportDeviceContext функции DxgkDdiAddDevice .

[in] pRecommendVidPnTopology

Указатель на структуру DXGKARG_RECOMMENDVIDPNTOPOLOGY , содержащую аргументы функции.

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

DxgkDdiRecommendVidPnTopology возвращает одно из следующих значений:

Код возврата Описание
STATUS_SUCCESS Функция успешно создана или дополнена топологией.
STATUS_GRAPHICS_NO_RECOMMENDED_VIDPN_TOPOLOGY Функция не имеет рекомендаций по дополнению указанной топологии VidPN.
STATUS_GRAPHICS_CANCEL_VIDPN_TOPOLOGY_AUGMENTATION Функция рекомендует отменить расширение указанной топологии VidPN в указанном источнике. Этот код возврата допускается только в случае расширения топологии VidPN.
STATUS_NO_MEMORY Сбой функции, так как ей не удалось выделить достаточно памяти.

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

Комментарии

DxgkDdiRecommendVidPnTopology следует сделать страничной.

Требования

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

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

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