GetPointerPenInfo, fonction (winuser.h)
Obtient les informations basées sur le stylet pour le pointeur spécifié (de type PT_PEN) associé au message actuel.
Syntaxe
BOOL GetPointerPenInfo(
[in] UINT32 pointerId,
[out] POINTER_PEN_INFO *penInfo
);
Paramètres
[in] pointerId
Identificateur du pointeur pour lequel récupérer des informations.
[out] penInfo
Adresse d’une structure de POINTER_PEN_INFO pour recevoir les informations de pointeur spécifiques au stylet.
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
GetPointerPenInfo récupère des informations pour un pointeur unique (de type PT_PEN) associé à un message de pointeur.
Utilisez GetPointerFramePenInfo pour récupérer les informations de trame associées à un message pour un ensemble de pointeurs.
Les informations retournées par GetPointerInfo sont associées au message de pointeur le plus récent récupéré par le thread appelant. Lorsque le message suivant est récupéré par le thread appelant, les informations associées au message précédent peuvent ne plus être disponibles.
Si l’application ne traite pas les messages d’entrée de pointeur aussi rapidement qu’ils sont générés, certains messages peuvent être fusionnés en un message WM_POINTERUPDATE . Utilisez GetPointerPenInfoHistory pour récupérer l’historique des messages à partir du message WM_POINTERUPDATE le plus récent.
Si les informations associées au message 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 à laquelle le message de pointeur a été remis, cette fonction échoue avec la dernière erreur définie sur ERROR_ACCESS_DENIED. Notez qu’il peut s’agir de la fenêtre à laquelle l’entrée a été remise à l’origine ou d’une fenêtre vers laquelle le message a été transféré.
Si le pointeur spécifié n’est pas de type PT_PEN, cette fonction échoue avec la dernière erreur définie sur ERROR_DATATYPE_MISMATCH.
Configuration requise
| 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 |