структура 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.

Требования

См. также

IddCxMonitorQueryHardwareCursor3