DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET回呼函式 (d3dkmddi.h)

發行項
02/25/2024

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 圖形核心子系統先前已將此句柄提供給 DxgkDdiStartDevice 函式之 DxgkInterface 參數中的顯示迷你埠驅動程式。

[in] VideoPresentTargetId

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

[out] pNumberModes

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

[out] ppAdditionalModesSet

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

傳回值

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

傳回碼	Description
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 所識別的影片簡報目標。