DXGKDDI_MONITOR_GETMONITORDESCRIPTORSET回呼函式 (d3dkmddi.h)
pfnGetMonitorDescriptorSet 函式會傳回與指定監視器相關聯之監視器描述項集物件的句柄。
語法
DXGKDDI_MONITOR_GETMONITORDESCRIPTORSET DxgkddiMonitorGetmonitordescriptorset;
NTSTATUS DxgkddiMonitorGetmonitordescriptorset(
[in] IN_CONST_D3DKMDT_ADAPTER hAdapter,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
[out] OUT_PD3DKMDT_HMONITORDESCRIPTORSET phMonitorDescriptorSet,
[out] DEREF_OUT_CONST_PPDXGK_MONITORDESCRIPTORSET_INTERFACE ppMonitorDescriptorSetInterface
)
{...}
參數
[in] hAdapter
識別顯示配接器的句柄。 Microsoft DirectX 圖形核心子系統先前已將此句柄提供給 DxgkDdiStartDevice 函式之 DxgkInterface 參數中的顯示迷你埠驅動程式。
[in] VideoPresentTargetId
整數，識別顯示配接器上的其中一個視訊呈現目標。 傳回的監視器描述項集合物件包含連接到此影片存在目標的監視器描述項。
[out] phMonitorDescriptorSet
接收監視描述項集物件句柄之變數的指標。
[out] ppMonitorDescriptorSetInterface
接收 DXGK_MONITORDESCRIPTORSET_INTERFACE 結構指標之變數的指標。 結構包含顯示迷你埠驅動程式可以呼叫的函式指標，以檢查和改變監視器描述元集物件。
傳回值
pfnGetMonitorDescriptorSet 函式會傳回下列其中一個值。
| 傳回碼 | 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 所識別的視訊簡訊簡報目標。 |
備註
顯示迷你埠驅動程式會指派 VidPN 目標識別碼。 由顯示迷你埠驅動程序實作的 DxgkDdiQueryChildRelations 函式會傳回 DXGK_CHILD_DESCRIPTOR 結構的數位，每個結構都包含標識符。
您不需要釋放 phMonitorDescriptorSet 中傳回的句柄。
從 Windows 7 開始，此函式也可以在 DXGK_MONITOR_INTERFACE_V2 介面中使用。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 目標平台 | 桌面 |
| 標頭 | d3dkmddi.h (包含 D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |