structure IDARG_OUT_QUERY_HWCURSOR2 (iddcx.h)

Une structure IDARG_OUT_QUERY_HWCURSOR2 est le paramètre de sortie utilisé par IddCxMonitorQueryHardwareCursor2 pour retourner des informations sur le curseur matériel actuel.

Syntaxe

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

Membres

IsCursorVisible

[out] Valeur booléenne qui indique si le curseur est visible.

X

[out] Si le curseur est visible (IsCursorVisible = TRUE), X est le x écran co-orné du pixel de main supérieure gauche dans l’image du curseur. Ce champ n’est valide que si PositionValid a la valeur TRUE. X peut être négatif ; par exemple, lorsqu’un point chaud au centre du curseur est placé en haut à gauche de l’écran.

Y

[out] Si le curseur est visible (IsCursorVisible = TRUE), Y est le y écran co-ordiné du pixel de main supérieure gauche dans l’image du curseur. Ce champ n’est valide que si PositionValid a la valeur TRUE. Y peut être négatif ; par exemple, lorsqu’un point chaud au centre du curseur est placé en haut à gauche de l’écran.

IsCursorShapeUpdated

[out] Valeur booléenne qui indique si la forme du curseur a été mise à jour depuis la dernière fois que le pilote a appelé IddCxMonitorQueryHardwareCursor2. S’il a été mis à jour, le système d’exploitation met à jour la structure CursorShapeInfo et copie les nouvelles données d’image de curseur dans le IDARG_IN_QUERY_HWCURSOR.mémoire tampon pShapeBuffer.

CursorShapeInfo

[out] Structure IDDCX_CURSOR_SHAPE_INFO dans laquelle le système d’exploitation copie les informations actuelles du curseur si le curseur est visible. Si le curseur n’est pas visible, le système d’exploitation supprime cette structure.

PositionValid

[out] Valeur booléenne qui indique si les champs X, Yet PositionId de cette structure sont valides.

PositionId

[out] ID de la dernière position de curseur reçue par le système d’exploitation pour ce moniteur. Le pilote peut comparer cet ID à la dernière position du curseur qu’il a traitée pour savoir s’il doit traiter une nouvelle mise à jour de position.

Notez qu’il existe des cas où les valeurs de position n’ont peut-être pas changées, mais que la valeur de l’ID de position a changé. Dans ce cas, le pilote doit traiter la position comme s’il s’agissait d’un nouveau déplacement. PositionId n’est pas mis à jour si IsCursorVisible change et n’est valide que si PositionValid a la valeur TRUE.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 11, version 22H2
d’en-tête	iddcx.h

Voir aussi

IddCxMonitorQueryHardwareCursor2