Share via


Función QueryVirtualMemoryInformation (memoryapi.h)

La función QueryVirtualMemoryInformation devuelve información sobre una página o un conjunto de páginas dentro del espacio de direcciones virtuales del proceso especificado.

Sintaxis

BOOL QueryVirtualMemoryInformation(
  [in]            HANDLE                         Process,
  [in]            const VOID                     *VirtualAddress,
  [in]            WIN32_MEMORY_INFORMATION_CLASS MemoryInformationClass,
  [out]           PVOID                          MemoryInformation,
  [in]            SIZE_T                         MemoryInformationSize,
  [out, optional] PSIZE_T                        ReturnSize
);

Parámetros

[in] Process

Identificador del proceso en cuyo contexto residen las páginas que se van a consultar.

[in] VirtualAddress

Dirección de la región de las páginas que se van a consultar. Este valor se redondea hacia abajo hasta el siguiente límite de dirección de página de host.

[in] MemoryInformationClass

Clase de información de memoria sobre la que se va a recuperar información. El único valor admitido es MemoryRegionInfo.

[out] MemoryInformation

Puntero a un búfer que recibe la información especificada.

Si el parámetro MemoryInformationClass tiene un valor de MemoryRegionInfo, este parámetro debe apuntar a una estructura WIN32_MEMORY_REGION_INFORMATION .

[in] MemoryInformationSize

Especifica la longitud en bytes del búfer de información de memoria.

[out, optional] ReturnSize

Puntero opcional que, si se especifica, recibe el número de bytes colocados en el búfer de información de memoria.

Valor devuelto

Devuelve TRUE si se realiza correctamente. Devuelve FALSE si se produce un error. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Si el parámetro MemoryInformationClass tiene un valor de MemoryRegionInfo, el parámetro MemoryInformation debe apuntar a una estructura WIN32_MEMORY_REGION_INFORMATION . El parámetro VirtualAddress debe apuntar a una dirección dentro de una asignación de memoria válida. Si el parámetro VirtualAddress apunta a una región de memoria sin asignar, se produce un error en la función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1607 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado memoryapi.h (incluya Windows.h)
Library Onecore.lib
Archivo DLL Api-ms-win-core-memory-l1-1-4.dll

Consulte también

Obtener último error

MEMORY_BASIC_INFORMATION

WIN32_MEMORY_REGION_INFORMATION