GetPointerInfo, fonction (winuser.h)
Obtient les informations du pointeur spécifié associé au message actuel.
Syntaxe
BOOL GetPointerInfo(
[in] UINT32 pointerId,
[out] POINTER_INFO *pointerInfo
);
Paramètres
[in] pointerId
Identificateur du pointeur.
[out] pointerInfo
Adresse d’une structure POINTER_INFO qui reçoit les informations du pointeur.
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
GetPointerInfo récupère des informations pour un pointeur unique associé à un message de pointeur.
Utilisez GetPointerFrameInfo pour récupérer des 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 GetPointerInfoHistory 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 le dernier paramètre d’erreur défini 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 vers laquelle l’entrée a été remise à l’origine ou d’une fenêtre vers laquelle le message a été transféré.
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 |
| Ensemble d’API | ext-ms-win-rtcore-ntuser-wmpointer-l1-1-0 (introduit dans Windows 10, version 10.0.14393) |