GetPointerPenInfoHistory, fonction (winuser.h)
Obtient les informations basées sur le stylet associées aux entrées individuelles, le cas échéant, qui ont été fusionnées dans le message actuel pour le pointeur spécifié (de type PT_PEN). L’entrée la plus récente est incluse dans l’historique retourné et est identique à l’entrée la plus récente retournée par la fonction GetPointerPenInfo .
Syntaxe
BOOL GetPointerPenInfoHistory(
[in] UINT32 pointerId,
[in, out] UINT32 *entriesCount,
[out, optional] POINTER_PEN_INFO *penInfo
);
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 penInfo . Si GetPointerPenInfoHistory réussit, entriesCount est mis à jour avec le nombre total de structures disponibles. Le nombre total de structures disponibles est identique au champ historyCount dans la structure POINTER_PEN_INFO retourné par un appel à GetPointerPenInfo.
[out, optional] penInfo
Adresse d’un tableau de structures POINTER_PEN_INFO pour recevoir les informations du pointeur. Ce paramètre peut avoir la valeur 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 mouvements peuvent être regroupés. Lorsqu’une application reçoit un message de pointeur pouvant être fusionné (de type PT_PEN), elle peut utiliser la fonction GetPointerPenInfoHistory 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 récupère 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 GetPointerPenInfo .
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 relatives au pointeur spécifié.
Si les informations associées au cadre de pointeur ne sont plus disponibles, cette fonction échoue avec le dernier paramètre d’erreur défini sur ERROR_NO_DATA.
Si le thread appelant n’est pas propriétaire de la fenêtre (où l’entrée a été remise à l’origine ou où le message a été transféré) vers laquelle le message du pointeur a été remis, cette fonction échoue avec la dernière erreur définie sur ERROR_ACCESS_DENIED.
Si le pointeur spécifié n’est pas de type PT_PEN, cette fonction échoue avec le dernier paramètre d’erreur défini sur ERROR_DATATYPE_MISMATCH.
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 |