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

Voir aussi

Fonctions

GetPointerFramePenInfo

GetPointerFramePenInfoHistory

GetPointerPenInfoHistory