IDARG_OUT_QUERY_HWCURSOR3结构（iddcx.h）

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以来是否已更新游标形状。 如果它已更新，则 OS 会更新 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 值已更改。 在这种情况下，驱动程序应像处理新移动一样处理位置。 PositionId 如果 IsCursorVisible 更改，并且仅在 PositionValid 为 TRUE 时有效。

SdrWhiteLevel

[out]光标的白色级别（以 nits 为单位）在与 HDR 内容组合时使用。

言论

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

要求

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

另请参阅

IddCxMonitorQueryHardwareCursor3