BlockInput, fonction (winuser.h)

Article
03/04/2024

Empêche les événements d’entrée du clavier et de la souris d’atteindre les applications.

Syntaxe

BOOL BlockInput(
  [in] BOOL fBlockIt
);

Paramètres

[in] fBlockIt

Type : BOOL

Objectif de la fonction. Si ce paramètre a la valeur TRUE, les événements d’entrée du clavier et de la souris sont bloqués. Si ce paramètre a la valeur FALSE, les événements de clavier et de souris sont débloqués. Notez que seul le thread qui a bloqué l’entrée peut débloquer correctement l’entrée.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si l’entrée est déjà bloquée, la valeur de retour est zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Lorsque l’entrée est bloquée, l’entrée physique réelle de la souris ou du clavier n’affecte pas l’état de touche synchrone de la file d’attente d’entrée (signalé par GetKeyState et GetKeyboardState), ni l’état de la touche asynchrone (signalé par GetAsyncKeyState). Toutefois, le thread qui bloque l’entrée peut affecter ces deux états clés en appelant SendInput. Aucun autre thread ne peut le faire.

Le système débloquera les entrées dans les cas suivants :

Le thread qui a bloqué l’entrée se ferme de manière inattendue sans appeler BlockInput avec fBlock défini sur FALSE. Dans ce cas, le système nettoie correctement et réactive l’entrée.
L’utilisateur appuie sur Ctrl+Alt+Suppr ou le système appelle le message modal Erreur système matérielle (par exemple, en cas d’erreur d’un programme ou de défaillance d’un appareil).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h
Bibliothèque	User32.lib
DLL	User32.dll