IDARG_OUT_QUERY_HWCURSOR2 structure (iddcx.h)

  • Article

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 la coordination de l’écran x du pixel de la 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 la co-coordination de l’écran y du pixel de la 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 de curseur actuelles si le curseur est visible. Si le curseur n’est pas visible, le système d’exploitation met à zéro cette structure.

PositionValid

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

PositionId

[out] ID de la dernière position du curseur que le système d’exploitation a reçu 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 que dans certains cas, les valeurs de position n’ont peut-être pas changées, mais 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 11, version 22H2
En-tête iddcx.h

Voir aussi

IddCxMonitorQueryHardwareCursor2