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

Voir aussi

Fonctions

GetPointerFramePenInfo

GetPointerFramePenInfoHistory

GetPointerPenInfo