IddCxMonitorQueryHardwareCursor3 函数 （iddcx.h）
间接显示驱动程序调用 IddCxMonitorQueryHardwareCursor3 来检索指定监视器的当前硬件游标信息。 如果监视器处于 HDR 模式，此函数版本将添加驱动程序必须应用于光标的 SDR 白级别。
语法
HRESULT IddCxMonitorQueryHardwareCursor3(
IDDCX_MONITOR MonitorObject,
const IDARG_IN_QUERY_HWCURSOR *pInArgs,
IDARG_OUT_QUERY_HWCURSOR3 *pOutArgs
);
参数
MonitorObject
[in]IDDCX_MONITOR 对象，该对象是由 IddCxMonitorCreate创建的监视器的 OS 上下文句柄。
pInArgs
指向包含此函数的输入参数的 IDARG_IN_QUERY_HWCURSOR 结构的指针。
pOutArgs
指向返回监视器当前硬件游标信息的 IDARG_OUT_QUERY_HWCURSOR3 结构的指针。
返回值
IddCxMonitorQueryHardwareCursor2 成功后返回STATUS_SUCCESS;否则，它将返回 相应的 NTSTATUS 错误代码。 STATUS_GRAPHICS_PATH_NOT_IN_TOPOLOGY的错误代码是一个暂时性错误，指示 MonitorObject 当前不在活动路径中。
言论
IddCxMonitorQueryHardwareCursor3 检索指定监视器的当前硬件游标信息，并将其置于 pOutArgs 指向的调用方提供的缓冲区中。 此函数非常类似于 IddCxMonitorQueryHardwareCursor2，但还提供了 SDR 白级别值。 SDR 白级别是必需的，因为所有光标图像都采用 SDR 格式，驱动程序需要确保它们以正确的亮度显示。
有关 HDR 支持的详细信息，请参阅 IddCx 版本 1.10 更新。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 11 版本 22H2 9 月更新（IddCx 版本 1.10） |
| 标头 | iddcx.h |