iddcx.h) (IDARG_OUT_QUERY_HWCURSOR3 结构

IDARG_OUT_QUERY_HWCURSOR3 结构是 IddCxMonitorQueryHardwareCursor3 用于返回当前硬件游标相关信息的输出参数。

语法

struct IDARG_OUT_QUERY_HWCURSOR3 {
  BOOL                    IsCursorVisible;
  INT                     X;
  INT                     Y;
  BOOL                    IsCursorShapeUpdated;
  IDDCX_CURSOR_SHAPE_INFO CursorShapeInfo;
  BOOL                    PositionValid;
  UINT                    PositionId;
  UINT                    SdrWhiteLevel;
};

成员

IsCursorVisible

[out]一个布尔值，指示游标是否可见。

X

[out]如果光标可见 (IsCursorVisible = TRUE) 则 X 是光标图像中左上角像素的 x 屏幕坐标。 仅当 PositionValid 为 TRUE 时，此字段才有效。 X 可以为负数;例如，当光标中心的热点放置在屏幕的左上角时。

Y

[out]如果光标可见 (IsCursorVisible = TRUE) 则 Y 是光标图像中左上角像素的 y 屏幕坐标。 仅当 PositionValid 为 TRUE 时，此字段才有效。 Y 可以为负数;例如，当光标中心的热点放置在屏幕的左上角时。

IsCursorShapeUpdated

[out]一个布尔值，指示自上次调用 IddCxMonitorQueryHardwareCursor3 的驱动程序以来是否更新了光标形状。 如果已更新，则操作系统会更新 CursorShapeInfo 结构，并将新的游标图像数据复制到 IDARG_IN_QUERY_HWCURSOR。pShapeBuffer 缓冲区。

CursorShapeInfo

[out] 一种IDDCX_CURSOR_SHAPE_INFO 结构，在该结构中，如果游标可见，OS 将复制当前游标信息。 如果游标不可见，则 OS 会将此结构归零。

PositionValid

[out]一个布尔值，指示此结构中的 X、 Y 和 PositionId 字段是否有效。

PositionId

[out]OS 为此监视器接收的最后一个游标位置的 ID。 驱动程序可以将此 ID 与处理的最后一个游标位置进行比较，以了解它是否应处理新位置更新。

请注意，在某些情况下，位置值可能未更改，但位置 ID 值已更改。 在这种情况下，驱动程序应像处理新移动一样处理位置。 如果 IsCursorVisible 更改，则 PositionId 不会更新，并且仅在 PositionValid 为 TRUE 时有效。

SdrWhiteLevel

[out]与 HDR 内容合成时要使用的光标的白色级别（以尼特为单位）。

注解

有关 HDR 支持的详细信息，请参阅 IddCx 版本 1.10 更新。

要求

要求	值
最低受支持的客户端	Windows 11，版本 22H2 9 月更新 (IddCx 版本 1.10)
标头	iddcx.h

另请参阅

IddCxMonitorQueryHardwareCursor3