структура 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. Если она была обновлена, ос обновляет структуру CursorShapeInfo и копирует данные нового изображения курсора в IDARG_IN_QUERY_HWCURSOR. Буфер pShapeBuffer .

CursorShapeInfo

[out] Структура IDDCX_CURSOR_SHAPE_INFO , в которой ОС копирует текущие сведения о курсоре, если курсор виден. Если курсор не отображается, операционная система обнуляет эту структуру.

PositionValid

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

PositionId

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

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

SdrWhiteLevel

[out] Белый уровень курсора (в нитах), используемый при создании содержимого HDR.

Комментарии

Дополнительные сведения о поддержке HDR см. в разделе Обновления IddCx версии 1.10.

Требования

Требование Значение
Минимальная версия клиента Windows 11, версия 22H2 сентябрьское обновление (IddCx версии 1.10)
Верхняя часть iddcx.h

См. также раздел

IddCxMonitorQueryHardwareCursor3