DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET回呼函式（d3dkmddi.h）

發行項
02/06/2025

pfnGetAdditionalMonitorModeSet 函式會傳回與指定監視器相關聯的其他監視器來源模式集物件的句柄。從 Windows 7 開始，它可在 DXGK_MONITOR_INTERFACE_V2 介面中使用。

語法

DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET DxgkddiMonitorGetadditionalmonitormodeset;

NTSTATUS DxgkddiMonitorGetadditionalmonitormodeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PUINT pNumberModes,
  [out] DEREF_ECOUNT_PPDXGK_TARGETMODE_DETAIL_TIMING ppAdditionalModesSet
)
{...}

參數

[in] hAdapter

識別顯示配接器的句柄。 Microsoft DirectX 圖形核心子系統先前已將此句柄提供給 DxgkInterface 參數中 DxgkDdiStartDevice 函式中的顯示迷你埠驅動程式。

[in] VideoPresentTargetId

整數，識別顯示適配卡上的其中一個影片呈現目標。傳回的 ppAdditionalModesSet 其他模式集物件描述連線到此影片呈現目標的監視器上可用的其他監視器來源模式集。

[out] pNumberModes

變數的指標，其中包含 VideoPresentTargetId所指定視訊目前目標的其他計時模式數目。

[out] ppAdditionalModesSet

接收 DXGK_TARGETMODE_DETAIL_TIMING 結構指標之變數的指標。結構描述影片呈現目標與顯示裝置相容的其他計時模式。

傳回值

pfnAcquireMonitorSourceModeSet 函式會傳回下列其中一個值。

傳回碼	描述
STATUS_SUCCESS	函式成功。
STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER	hAdapter 中提供的句柄無效。
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET	VideoPresentTargetId 中提供的標識碼無效。
STATUS_GRAPHICS_MONITOR_NOT_CONNECTED	沒有監視器連線到 VideoPresentTargetId 所識別的視訊簡訊簡報目標。
STATUS_NOT_FOUND	找不到 VideoPresentTargetId 所識別的影片目前目標。