Fonction BeginDeferWindowPos (winuser.h)

Article
03/04/2024

Alloue de la mémoire pour une structure à plusieurs positions de fenêtre et retourne le handle à la structure.

Syntaxe

HDWP BeginDeferWindowPos(
  [in] int nNumWindows
);

Paramètres

[in] nNumWindows

Type : int

Nombre initial de fenêtres pour lesquelles stocker des informations de position. La fonction DeferWindowPos augmente la taille de la structure, si nécessaire.

Valeur retournée

Type : HDWP

Si la fonction réussit, la valeur de retour identifie la structure à plusieurs positions de fenêtres. Si des ressources système insuffisantes sont disponibles pour allouer la structure, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La structure à plusieurs positions de fenêtre est une structure interne ; une application ne peut pas y accéder directement.

DeferWindowPos remplit la structure à plusieurs positions de fenêtres avec des informations sur la position cible d’une ou plusieurs fenêtres sur le point d’être déplacées. La fonction EndDeferWindowPos accepte le handle de cette structure et repositionne les fenêtres à l’aide des informations stockées dans la structure.

Si le système doit augmenter la taille de la structure à plusieurs fenêtres au-delà de la taille initiale spécifiée par le paramètre nNumWindows , mais ne peut pas allouer suffisamment de mémoire pour ce faire, le système échoue à l’ensemble de la séquence de positionnement de fenêtre (BeginDeferWindowPos, DeferWindowPos et EndDeferWindowPos). En spécifiant la taille maximale nécessaire, une application peut détecter et traiter les défaillances au début du processus.

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 (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-window-l1-1-4 (introduit dans Windows 10, version 10.0.14393)