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

與顯示配接器相關聯的內容區塊句柄。顯示迷你埠驅動程式先前已將此句柄提供給 MiniportDeviceContextDxgkDdiAddDevice 函式的 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 所指定的 gamma 坡道 ->VidPnPresentPathInfo.GammaRamp。

言論

作系統會呼叫 DxgkDdiUpdateActiveVidPnPresentPath 函式來控制視訊簡訊簡訊的設定，例如路徑旋轉、呈現的內容幾何轉換、用來調整呈現內容的亮度的伽瑪坡度等等。

注意顯示迷你埠驅動程式的 DxgkDdiUpdateActiveVidateActiveVidPnPresentPath 函式必須支援 gamma 坡形。

從 Windows 8 開始，如果顯示迷你埠驅動程式設定 SupportSmoothRotationDXGK_DRIVERCAPS 結構的成員，則必須支援使用 DxgkDdiUpdateActiveVidPnPresentPath 函式更新適配卡的路徑旋轉。驅動程式必須一律能夠在呼叫 DxgkDdiCommitVidPn 函式期間設定路徑輪替。

DxgkDdiUpdateActiveVidPnPresentPath 函式應設為可分頁。