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 |