DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH回呼函式 (d3dkmddi.h)

發行項
02/23/2024

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會傳回下列其中一個值：

值	Description
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> 所指定的 Gamma 坡形。

備註

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

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

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

DxgkDdiUpdateActiveVidPnPresentPath 函式應設為可分頁。