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

  • Статья

Функция 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>.

Комментарии

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

Примечание Функция DxgkDdiUpdateActiveVidPnPresentPath драйвера мини-порта дисплея должна поддерживать гамма-пандусы.
 
Начиная с 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