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

与显示适配器关联的上下文块的句柄。显示微型端口驱动程序以前向 MiniportDeviceContext 中的 Microsoft DirectX 图形内核子系统提供了此句柄，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指定的 gamma 渐变 ->VidPnPresentPathInfo.GammaRamp。

言论

作系统调用 DxgkDdiUpdateActiveVidPnPresentPath 函数来控制视频演示路径的设置，例如路径旋转、呈现的内容几何转换、用于调整呈现内容的亮度的伽玛渐变等。

注意显示微型端口驱动程序的 DxgkDdiUpdateActiveVidateActiveVidateActiveVidpnPresentPath 函数必须支持伽玛渐变。

从 Windows 8 开始，如果显示微型端口驱动程序设置 SupportSmoothRotationDXGK_DRIVERCAPS 结构的成员，则必须支持使用 DxgkDdiUpdateActiveVidPnPresentPath 函数更新适配器上的路径旋转。驱动程序必须始终能够在调用 DxgkDdiCommitVidPn 函数期间设置路径轮换。

应将 DxgkDdiUpdateActiveVidPnPresentPath 函数设为可分页。