Funzione QueryVirtualMemoryInformation (memoryapi.h)

Articolo
02/28/2024

La funzione QueryVirtualMemoryInformation restituisce informazioni su una pagina o un set di pagine all'interno dello spazio indirizzi virtuale del processo specificato.

Sintassi

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
);

Parametri

[in] Process

Handle per il processo nel cui contesto risiedono le pagine da eseguire.

[in] VirtualAddress

Indirizzo dell'area delle pagine da eseguire query. Questo valore viene arrotondato fino al limite host-page-address successivo.

[in] MemoryInformationClass

Classe di informazioni sulla memoria su cui recuperare informazioni. L'unico valore supportato è MemoryRegionInfo.

[out] MemoryInformation

Puntatore a un buffer che riceve le informazioni specificate.

Se il parametro MemoryInformationClass ha un valore di MemoryRegionInfo, questo parametro deve puntare a una struttura WIN32_MEMORY_REGION_INFORMATION .

[in] MemoryInformationSize

Specifica la lunghezza in byte del buffer delle informazioni sulla memoria.

[out, optional] ReturnSize

Puntatore facoltativo che, se specificato, riceve il numero di byte inseriti nel buffer delle informazioni sulla memoria.

Valore restituito

Restituisce TRUE al successo. Restituisce FALSE per l'errore. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Se il parametro MemoryInformationClass ha un valore memoryRegionInfo, il parametro MemoryInformation deve puntare a una struttura WIN32_MEMORY_REGION_INFORMATION . Il parametro VirtualAddress deve puntare a un indirizzo all'interno di un'allocazione di memoria valida. Se il parametro VirtualAddress punta a un'area di memoria non associata, la funzione ha esito negativo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 versione 1607 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	memoryapi.h (include Windows.h)
Libreria	Onecore.lib
DLL	Api-ms-win-core-memory-l1-1-4.dll

Vedi anche

Getlasterror

MEMORY_BASIC_INFORMATION

WIN32_MEMORY_REGION_INFORMATION

Condividi tramite