IDARG_OUT_QUERY_HWCURSOR3 structure (iddcx.h)

Article
02/29/2024

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

SdrWhiteLevel

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

Remarques

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	mise à jour de septembre Windows 11 version 22H2 (IddCx version 1.10)
En-tête	iddcx.h

Voir aussi

IddCxMonitorQueryHardwareCursor3

Partager via