IDARG_OUT_QUERY_HWCURSOR2 结构 (iddcx.h)

IDARG_OUT_QUERY_HWCURSOR2 结构是 IddCxMonitorQueryHardwareCursor2 用于返回有关当前硬件游标的信息的输出参数。

语法

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

成员

IsCursorVisible

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

X

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

Y

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

IsCursorShapeUpdated

[out]一个布尔值，指示自上次驱动程序调用 IddCxMonitorQueryHardwareCursor2 以来是否更新了光标形状。 如果已更新，则操作系统会更新 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 时有效。

要求

要求	值
最低受支持的客户端	Windows 11 版本 22H2
标头	iddcx.h

另请参阅

IddCxMonitorQueryHardwareCursor2