DXGKDDI_MONITOR_GETMONITORFREQUENCYRANGESET回呼函式 (d3dkmddi.h)

  • 發行項

pfnGetMonitorFrequencyRangeSet 函式會傳回與指定監視器相關聯的監視頻率範圍集物件句柄。

語法

DXGKDDI_MONITOR_GETMONITORFREQUENCYRANGESET DxgkddiMonitorGetmonitorfrequencyrangeset;

NTSTATUS DxgkddiMonitorGetmonitorfrequencyrangeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PD3DKMDT_HMONITORFREQUENCYRANGESET phMonitorFrequencyRangeSet,
  [out] DEREF_OUT_CONST_PPDXGK_MONITORFREQUENCYRANGESET_INTERFACE ppMonitorFrequencyRangeSetInterface
)
{...}

參數

[in] hAdapter

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

[in] VideoPresentTargetId

整數，識別顯示配接器上的其中一個視訊呈現目標。 傳回的監視頻率範圍集物件描述連接到此視訊存在目標的監視器上可用的頻率範圍。

[out] phMonitorFrequencyRangeSet

接收監視頻率範圍集物件句柄之變數的指標。

[out] ppMonitorFrequencyRangeSetInterface

接收 DXGK_MONITORFREQUENCYRANGESET_INTERFACE 結構指標之變數的指標。 結構包含顯示迷你埠驅動程式可以呼叫的函式指標，以檢查和改變監視頻率範圍集物件。

傳回值

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

傳回碼 Description
STATUS_SUCCESS 此函數已成功。
STATUS_INVALID_PARAMETER 提供無效的參數。
STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER hAdapter 中提供的句柄無效。
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET VideoPresentTargetId 中提供的標識碼無效。
STATUS_GRAPHICS_MONITOR_NOT_CONNECTED 沒有任何監視器連線到 VideoPresentTargetId 所識別的視訊簡訊簡報目標。

此函式也可能傳回 Ntstatus.h 中定義的其他錯誤碼。

備註

顯示迷你埠驅動程式會指派 VidPN 目標識別碼。 顯示迷你埠驅動程式所實作的 DxgkDdiQueryChildRelations 函式會傳回DXGK_CHILD_DESCRIPTOR 結構的數位，每個結構都包含標識碼。

您不需要釋放 phMonitorFrequencyRangeSet 中傳回的句柄。

從 Windows 7 開始，此函式也可以在 DXGK_MONITOR_INTERFACE_V2 介面中使用。

規格需求

需求 值
最低支援的用戶端 Windows Vista
目標平台 桌面
標頭 d3dkmddi.h (包含 D3dkmddi.h)
IRQL PASSIVE_LEVEL

另請參閱

DXGK_MONITOR_INTERFACE_V2

DxgkDdiEnumVidPnCofuncModality