Función FreeUserPhysicalPages (memoryapi.h)

Artículo
03/05/2024

Libera páginas de memoria físicas asignadas anteriormente mediante AllocateUserPhysicalPages o AllocateUserPhysicalPagesNuma. Si alguna de estas páginas se asigna actualmente en la región Extensiones de ventanas de direcciones (AWE), esta llamada las desasigna automáticamente. Esto no afecta al espacio de direcciones virtuales ocupado por una región especificada de Extensiones de ventanas de direcciones (AWE).

Windows de 64 bits en sistemas basados en Itanium: Debido a la diferencia en los tamaños de página, FreeUserPhysicalPages no es compatible con las aplicaciones de 32 bits.

Sintaxis

BOOL FreeUserPhysicalPages(
  [in]      HANDLE     hProcess,
  [in, out] PULONG_PTR NumberOfPages,
  [in]      PULONG_PTR PageArray
);

Parámetros

[in] hProcess

Identificador de un proceso.

La función libera memoria dentro del espacio de direcciones virtuales de este proceso.

[in, out] NumberOfPages

Tamaño de la memoria física que se va a liberar, en páginas.

Si se produce un error en la función, este parámetro indica el número de páginas que se liberan.

[in] PageArray

Puntero a una matriz de números de fotogramas de página de la memoria asignada que se va a liberar.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE. En este caso, el parámetro NumberOfPages refleja cuántas páginas se han publicado realmente. Para obtener información de error extendida, llame a GetLastError.

Comentarios

En un entorno de varios procesadores, esta función mantiene la coherencia del búfer de traducción de hardware. Cuando se devuelve esta función, se garantiza que todos los subprocesos de todos los procesadores vean la asignación correcta.

Para compilar una aplicación que use esta función, defina la macro _WIN32_WINNT como 0x0500 o posterior. Para obtener más información, vea Uso de los encabezados de Windows.

Ejemplos

Para obtener un ejemplo, vea Ejemplo de AWE.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	memoryapi.h (incluya Windows.h, Memoryapi.h)
Library	onecore.lib
Archivo DLL	Kernel32.dll