Partager via


GetPointerInfo, fonction (winuser.h)

Obtient les informations du pointeur spécifié associé au message actuel.

Note Utilisez GetPointerType si vous n’avez pas besoin des informations supplémentaires exposées par GetPointerInfo.
 

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)

Voir aussi

Fonctions

GetPointerFrameInfo

GetPointerFrameInfoHistory

GetPointerInfoHistory