structure IDARG_OUT_QUERY_HWCURSOR3 (iddcx.h)

Article
02/07/2025

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

Syntaxe

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

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é IddCxMonitorQueryHardwareCursor3. 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.

SdrWhiteLevel

[out] Niveau blanc du curseur, dans les nits, à utiliser lors de la composition avec du contenu HDR.

Remarques

Pour plus d’informations sur la prise en charge HDR, consultez mises à jour IddCx version 1.10.

Exigences

Exigence	Valeur
client minimum pris en charge	Mise à jour de septembre de Windows 11 version 22H2 (IddCx version 1.10)
d’en-tête	iddcx.h

Voir aussi

IddCxMonitorQueryHardwareCursor3

Partager via