estructura de IDARG_OUT_QUERY_HWCURSOR3 (iddcx.h)
Una estructura de IDARG_OUT_QUERY_HWCURSOR3 es el parámetro de salida usado por IddCxMonitorQueryHardwareCursor3 para devolver información sobre el cursor de hardware actual.
Sintaxis
struct IDARG_OUT_QUERY_HWCURSOR3 {
BOOL IsCursorVisible;
INT X;
INT Y;
BOOL IsCursorShapeUpdated;
IDDCX_CURSOR_SHAPE_INFO CursorShapeInfo;
BOOL PositionValid;
UINT PositionId;
UINT SdrWhiteLevel;
};
Miembros
IsCursorVisible
[out] Valor booleano que indica si el cursor está visible.
X
[out] Si el cursor está 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 está 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 IddCxMonitorQueryHardwareCursor3. 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 recibió el sistema operativo 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.
SdrWhiteLevel
[out] Nivel blanco del cursor, en nits, que se va a usar al componer con contenido HDR.
Comentarios
Para obtener más información sobre la compatibilidad con HDR, consulta Actualizaciones de iddCx versión 1.10.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 11, versión 22H2, actualización de septiembre (IddCx versión 1.10) |
| Encabezado | iddcx.h |