Fonction QueryVirtualMemoryInformation (memoryapi.h)

  • Article

La fonction QueryVirtualMemoryInformation retourne des informations sur une page ou un ensemble de pages dans l’espace d’adressage virtuel du processus spécifié.

Syntaxe

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

Paramètres

[in] Process

Handle pour le processus dans lequel résident les pages à interroger.

[in] VirtualAddress

Adresse de la région des pages à interroger. Cette valeur est arrondie à la limite d’adresse de page d’hôte suivante.

[in] MemoryInformationClass

Classe d’informations mémoire sur laquelle récupérer des informations. La seule valeur prise en charge est MemoryRegionInfo.

[out] MemoryInformation

Pointeur vers une mémoire tampon qui reçoit les informations spécifiées.

Si le paramètre MemoryInformationClass a la valeur MemoryRegionInfo, ce paramètre doit pointer vers une structure WIN32_MEMORY_REGION_INFORMATION .

[in] MemoryInformationSize

Spécifie la longueur en octets de la mémoire tampon d’informations.

[out, optional] ReturnSize

Pointeur facultatif qui, s’il est spécifié, reçoit le nombre d’octets placés dans la mémoire tampon d’informations de mémoire.

Valeur retournée

Retourne TRUE en cas de réussite. Retourne FALSE en cas d’échec. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Si le paramètre MemoryInformationClass a la valeur MemoryRegionInfo, le paramètre MemoryInformation doit pointer vers une structure WIN32_MEMORY_REGION_INFORMATION . Le paramètre VirtualAddress doit pointer vers une adresse dans une allocation de mémoire valide. Si le paramètre VirtualAddress pointe vers une région de mémoire non allouée, la fonction échoue.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1607 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2016 (applications de bureau uniquement)
Plateforme cible Windows
En-tête memoryapi.h (inclure Windows.h)
Bibliothèque Onecore.lib
DLL Api-ms-win-core-memory-l1-1-4.dll

Voir aussi

Obtenir la dernière erreur

MEMORY_BASIC_INFORMATION

WIN32_MEMORY_REGION_INFORMATION