Función FreeUserPhysicalPages (memoryapi.h)
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 |