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

Статья
02/06/2025

Функция DxgkDdiUpdateActiveVidPnPresentPath обновляет один из активных путей видео, которые в настоящее время активны на адаптере дисплея.

Синтаксис

DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH DxgkddiUpdateactivevidpnpresentpath;

NTSTATUS DxgkddiUpdateactivevidpnpresentpath(
       IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_UPDATEACTIVEVIDPNPRESENTPATH_CONST pUpdateActiveVidPnPresentPath
)
{...}

Параметры

hAdapter

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

[in] pUpdateActiveVidPnPresentPath

Указатель на структуру DXGKARG_UPDATEACTIVEVIDPNPRESENTPATH, которая содержит один элемент: D3DKMDT_VIDPN_PRESENT_PATH структуру. Члены структуры D3DKMDT_VIDPN_PRESENT_PATH определяют путь и предоставляют новые параметры для пути. Функция DxgkDdiUpdateActiveVidPnPresentPath должна программировать путь на адаптере отображения в соответствии с новыми параметрами.

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

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

Ценность	Описание
STATUS_SUCCESS	Функция завершилась успешно.
STATUS_GRAPHICS_PATH_NOT_IN_TOPOLOGY	Путь, указанный pUpdateActiveVidPnPresentPathArg->VidPnPresentPathInfo не находится в топологии активного VidPN.
STATUS_GRAPHICS_PATH_CONTENT_GEOMETRY_TRANSFORMATION_NOT_SUPPORTED	Путь не поддерживает преобразование содержимого, указанное pUpdateActiveVidPnPresentPathArg—>VidPnPresentPathInfo.ContentTransformation. Путь не поддерживает гамма-пандус, указанный pUpdateActiveVidPnPresentPathArg->VidPnPresentPathInfo.GammaRamp.

Замечания

Операционная система вызывает функцию DxgkDdiUpdateActiveVidPresentPath для управления параметрами присутствующих видео путей, таких как поворот пути, геометрия содержимого, гамма-пандусы, используемые для настройки яркости представленного содержимого и т. д.

Примечание Функция драйвера минипорта дисплея DxgkDdiUpdateActiveVidPresentPath должна поддерживать гамма-пандусы.

Начиная с Windows 8, если драйвер мини-порта отображения задает SupportSmoothRotation член структуры DXGK_DRIVERCAPS, он должен поддерживать обновление поворота пути на адаптере с помощью функции DxgkDdiUpdateActiveVidPnPresentPath. Драйвер всегда должен иметь возможность задать поворот пути во время вызова функции DxgkDdiCommitVidPn.

Функция DxgkDdiUpdateActiveVidPnPresentPath должна быть доступной для страницы.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
целевая платформа	Настольный
заголовка	d3dkmddi.h
IRQL	PASSIVE_LEVEL

См. также

D3DKMDT_VIDPN_PRESENT_PATH

DXGKARG_UPDATEACTIVEVIDPNPRESENTPATH

DXGK_DRIVERCAPS

DxgkDdiAddDevice

DxgkDdiCommitVidPn

Поделиться через