Поделиться через

структура 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, в которой ОС копирует текущие сведения о курсоре, если курсор отображается. Если курсор не отображается, ОС обнуляет эту структуру.

PositionValid

[out] Логическое значение, указывающее, допустимы ли поля X, Yи PositionId в этой структуре.

PositionId

[out] Идентификатор последней позиции курсора, полученной ОС для этого монитора. Драйвер может сравнить этот идентификатор с последней позицией курсора, которую он обработал, чтобы узнать, следует ли обработать новое обновление позиции.

Обратите внимание, что существуют случаи, когда значения позиции могут не измениться, но значение идентификатора позиции изменилось. В этом случае драйвер должен обработать позицию, как если бы это было новое перемещение. PositionId не обновляется, если IsCursorVisible изменения и допустимы только в том случае, если PositionValid имеет значение TRUE.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 11, версия 22H2
заголовка iddcx.h

См. также

IddCxMonitorQueryHardwareCursor2