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 函数返回以下值之一。
| 返回代码 | 描述 |
|---|---|
| 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 |