GetPointerInfoHistory, fonction (winuser.h)
Obtient les informations associées aux entrées individuelles, le cas échéant, qui ont été fusionnées dans le message actuel pour le pointeur spécifié. L’entrée la plus récente est incluse dans l’historique renvoyé et est identique à l’entrée la plus récente retournée par la fonction GetPointerInfo .
Syntaxe
BOOL GetPointerInfoHistory(
[in] UINT32 pointerId,
[in, out] UINT32 *entriesCount,
[out, optional] POINTER_INFO *pointerInfo
);
Paramètres
[in] pointerId
Identificateur du pointeur pour lequel récupérer des informations.
[in, out] entriesCount
Pointeur vers une variable qui spécifie le nombre de structures dans la mémoire tampon vers lesquelles pointe pointerInfo. Si GetPointerInfoHistory réussit, entriesCount est mis à jour avec le nombre total de structures disponibles. Le nombre total de structures disponibles est identique au champ historyCount de la structure POINTER_INFO retournée par un appel à GetPointerInfo.
[out, optional] pointerInfo
Adresse d’un tableau de structures POINTER_INFO pour recevoir les informations du pointeur. Ce paramètre peut être NULL si *entriesCount est égal à zéro.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Si l’application ne traite pas les messages d’entrée de pointeur aussi rapidement qu’ils sont générés, certains déplacements peuvent être regroupés. Lorsqu’une application reçoit un message de pointeur pouvant être fusionné, elle peut utiliser la fonction GetPointerInfoHistory pour récupérer des informations pour toutes les entrées individuelles, le cas échéant, qui ont été fusionnées dans le message. Notez que les informations récupérées sont associées au message de pointeur le plus récemment récupéré par le thread appelant. Une fois que le thread appelant a récupéré son message suivant, les informations associées au message précédent peuvent ne plus être disponibles.
Les informations récupérées apparaissent dans l’ordre chronologique inverse, avec l’entrée la plus récente dans la première ligne du tableau retourné. L’entrée la plus récente est la même que celle retournée par la fonction GetPointerInfo .
Si le nombre de lignes dans la mémoire tampon fournie est insuffisant pour contenir toutes les entrées d’historique disponibles, cette fonction réussit avec la mémoire tampon contenant les entrées les plus récentes et *entriesCount contenant le nombre total d’entrées disponibles.
Si le cadre de pointeur ne contient aucun pointeur supplémentaire en dehors du pointeur spécifié, cette fonction réussit et retourne uniquement les informations du pointeur spécifié.
Si les informations associées au cadre de pointeur ne sont plus disponibles, cette fonction échoue avec la dernière erreur définie sur ERROR_NO_DATA.
Si le thread appelant ne possède pas la fenêtre (où l’entrée a été remise à l’origine ou où le message a été transféré) à laquelle le message de pointeur a été remis, cette fonction échoue avec la dernière erreur définie sur ERROR_ACCESS_DENIED.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winuser.h (inclure Windows.h) |
| Bibliothèque | User32.lib |
| DLL | User32.dll |