DXGKDDI_MONITOR_ACQUIREMONITORSOURCEMODESET回调函数 (d3dkmddi.h)
pfnAcquireMonitorSourceModeSet 函数返回与指定监视器关联的监视器源模式集对象的句柄。
语法
DXGKDDI_MONITOR_ACQUIREMONITORSOURCEMODESET DxgkddiMonitorAcquiremonitorsourcemodeset;
NTSTATUS DxgkddiMonitorAcquiremonitorsourcemodeset(
[in] IN_CONST_D3DKMDT_ADAPTER hAdapter,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
[out] OUT_PD3DKMDT_HMONITORSOURCEMODESET phMonitorSourceModeSet,
[out] DEREF_OUT_CONST_PPDXGK_MONITORSOURCEMODESET_INTERFACE ppMonitorSourceModeSetInterface
)
{...}
参数
[in] hAdapter
标识显示适配器的句柄。 Microsoft DirectX 图形内核子系统以前在 DxgkDdiStartDevice 函数的 DxgkInterface 参数中向显示微型端口驱动程序提供了此句柄。
[in] VideoPresentTargetId
一个整数，标识显示适配器上的其中一个视频存在目标。 返回的源模式集对象描述连接到此视频呈现目标的监视器上可用的模式。
[out] phMonitorSourceModeSet
指向接收监视源模式集对象的句柄的变量的指针。
[out] ppMonitorSourceModeSetInterface
指向变量的指针，该变量接收指向 DXGK_MONITORSOURCEMODESET_INTERFACE 结构的指针。 结构包含指向显示微型端口驱动程序可以调用以检查和更改监视器源模式集对象的函数的指针。
返回值
pfnAcquireMonitorSourceModeSet 函数返回以下值之一。
| 返回代码 | 说明 |
|---|---|
| STATUS_SUCCESS | 函数成功。 |
| 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 结构的数组，其中每个结构都包含标识符。
使用完监视源模式集对象句柄后，必须通过调用 pfnReleaseMonitorSourceModeSet 释放句柄。 对目标模式集对象进行引用计数，因此，如果多次获取句柄，则必须释放该句柄的次数相同。
从 Windows 7 开始， DXGK_MONITOR_INTERFACE_V2 接口中也提供此函数。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 目标平台 | 桌面 |
| 标头 | d3dkmddi.h (包括 D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |