Fonction DefScreenSaverProc (scrnsave.h)

Article
03/01/2024

Fournit le traitement par défaut pour tous les messages qu’une application d’économiseur d’écran ne traite pas.

Syntaxe

LRESULT DefScreenSaverProc(
  HWND   hWnd,
  UINT   msg,
  WPARAM wParam,
  LPARAM lParam
);

Paramètres

hWnd

Type : HWND

Identificateur de la fenêtre d’économiseur d’écran.

msg

Type : UINT

Message à traiter. La fonction DefScreenSaverProc répond aux messages qui affectent le fonctionnement de l’économiseur d’écran, comme indiqué dans la section Remarques.

Si une application d’économiseur d’écran doit effectuer une action différente en réponse à l’un de ces messages, la procédure de fenêtre ScreenSaverProc de l’application doit traiter le message.

wParam

Type : WPARAM

Informations supplémentaires spécifiques au message.

lParam

Type : LPARAM

Informations supplémentaires spécifiques au message.

Valeur retournée

Type : LONG

La valeur de retour spécifie le résultat du traitement du message et dépend du message envoyé.

Remarques

La procédure de fenêtre ScreenSaverProc d’une application d’économiseur d’écran doit utiliser DefScreenSaverProc au lieu de la fonction DefWindowProc pour fournir le traitement des messages par défaut. La fonction DefScreenSaverProc transmet tous les messages qui n’affectent pas l’opération d’économiseur d’écran à DefWindowProc.

Le tableau suivant décrit comment DefScreenSaverProc traite divers messages de fenêtre.

Message	Description
WM_ACTIVATE, WM_ACTIVATEAPP , WM_NCACTIVATE	Ferme l’économiseur d’écran si le paramètre wParam est FALSE. Une valeur wParamfalse indique que l’économiseur d’écran perd le focus d’entrée. L’économiseur d’écran est fermé en envoyant un message WM_CLOSE .
WM_SETCURSOR	Supprime le curseur de l’écran en définissant le curseur sur NULL.
WM_LBUTTONDOWN, WM_RBUTTONDOWN, WM_MBUTTONDOWN, WM_KEYDOWN, WM_KEYUP, WM_MOUSEMOVE	Appelle la fonction PostQuitMessage pour fermer l’économiseur d’écran.
WM_DESTROY	Publie un message WM_CLOSE pour fermer la fenêtre d’économiseur d’écran.
WM_SYSCOMMAND	Retourne FALSE si le paramètre wParam de WM_SYSCOMMAND est SC_CLOSE ou SC_SCREENSAVE.

Configuration requise

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

Partager via