DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH回调函数 (d3dkmddi.h)

项目
05/26/2023

DxgkDdiUpdateActiveVidPnPresentPath 函数更新显示适配器上当前处于活动状态的视频呈现路径之一。

语法

DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH DxgkddiUpdateactivevidpnpresentpath;

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

参数

hAdapter

与显示适配器关联的上下文块的句柄。显示微型端口驱动程序之前在 DxgkDdiAddDevice 函数的 MiniportDeviceContext 输出参数中向 Microsoft DirectX 图形内核子系统提供了此句柄。

[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 函数必须支持 gamma 渐变。

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

应使 DxgkDdiUpdateActiveVidPnPresentPath 函数可分页。