iddCxMonitorQueryHardwareCursor3 函数 (iddcx.h)

项目
02/26/2024

间接显示驱动程序调用 IddCxMonitorQueryHardwareCursor3 来检索指定监视器的当前硬件游标信息。此函数版本添加了 SDR 白级别，如果监视器处于 HDR 模式，驱动程序必须将其应用于光标。

语法

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 更新。