estructura IDARG_OUT_QUERY_HWCURSOR2 (iddcx.h)

Una estructura de IDARG_OUT_QUERY_HWCURSOR2 es el parámetro de salida usado por IddCxMonitorQueryHardwareCursor2 para devolver información sobre el cursor de hardware actual.

Sintaxis

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

Miembros

IsCursorVisible

[out] Valor booleano que indica si el cursor está visible.

X

[out] Si el cursor es visible (IsCursorVisible = TRUE), X es la coordenada de la pantalla x del píxel de la parte superior izquierda de la imagen del cursor. Este campo solo es válido si PositionValid es TRUE. X puede ser negativo; por ejemplo, cuando se coloca un punto activo en el centro del cursor en la parte superior izquierda de la pantalla.

Y

[out] Si el cursor es visible (IsCursorVisible = TRUE), Y es la coordenada de pantalla y del píxel de la mano superior izquierda en la imagen del cursor. Este campo solo es válido si PositionValid es TRUE. Y puede ser negativo; por ejemplo, cuando se coloca un punto activo en el centro del cursor en la parte superior izquierda de la pantalla.

IsCursorShapeUpdated

[out] Valor booleano que indica si la forma del cursor se ha actualizado desde la última vez que el controlador llamó a IddCxMonitorQueryHardwareCursor2. Si se ha actualizado, el sistema operativo actualiza la estructura CursorShapeInfo y copia los nuevos datos de imagen de cursor en el IDARG_IN_QUERY_HWCURSOR. Búfer de pShapeBuffer .

CursorShapeInfo

[out] Estructura IDDCX_CURSOR_SHAPE_INFO en la que el sistema operativo copia la información actual del cursor si el cursor está visible. Si el cursor no está visible, el sistema operativo cero esta estructura.

PositionValid

[out] Valor booleano que indica si los campos X, Y y PositionId de esta estructura son válidos.

PositionId

[out] Identificador de la última posición del cursor que el sistema operativo recibió para este monitor. El controlador puede comparar este identificador con la última posición del cursor que procesó para saber si debe procesar una nueva actualización de posición.

Tenga en cuenta que hay casos en los que es posible que los valores de posición no hayan cambiado, pero el valor del identificador de posición ha cambiado. En este caso, el controlador debe procesar la posición como si fuera un nuevo movimiento. PositionId no se actualiza si IsCursorVisible cambia y solo es válido si PositionValid es TRUE.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 11, versión 22H2
Encabezado	iddcx.h

Consulte también

IddCxMonitorQueryHardwareCursor2