Función BeginDeferWindowPos (winuser.h)

Artículo
03/15/2023

Asigna memoria para una estructura de posición de varias ventanas y devuelve el identificador a la estructura.

Sintaxis

HDWP BeginDeferWindowPos(
  [in] int nNumWindows
);

Parámetros

[in] nNumWindows

Tipo: int

Número inicial de ventanas para las que se va a almacenar la información de posición. La función DeferWindowPos aumenta el tamaño de la estructura, si es necesario.

Valor devuelto

Tipo: HDWP

Si la función se realiza correctamente, el valor devuelto identifica la estructura de posición de varias ventanas. Si no hay suficientes recursos del sistema disponibles para asignar la estructura, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La estructura de posición de varias ventanas es una estructura interna; una aplicación no puede acceder a ella directamente.

DeferWindowPos rellena la estructura de posición de varias ventanas con información sobre la posición de destino de una o varias ventanas a punto de moverse. La función EndDeferWindowPos acepta el identificador de esta estructura y cambia la posición de las ventanas mediante la información almacenada en la estructura.

Si el sistema debe aumentar el tamaño de la estructura de posición de varias ventanas más allá del tamaño inicial especificado por el parámetro nNumWindows , pero no puede asignar suficiente memoria para hacerlo, el sistema produce un error en toda la secuencia de posicionamiento de ventanas (BeginDeferWindowPos, DeferWindowPos y EndDeferWindowPos). Al especificar el tamaño máximo necesario, una aplicación puede detectar y procesar un error al principio del proceso.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-window-l1-1-4 (introducido en Windows 10, versión 10.0.14393)