QueryVirtualMemoryInformation-Funktion (memoryapi.h)
Die QueryVirtualMemoryInformation-Funktion gibt Informationen zu einer Seite oder einer Reihe von Seiten innerhalb des virtuellen Adressraums des angegebenen Prozesses zurück.
Syntax
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
);
Parameter
[in] Process
Ein Handle für den Prozess, in dessen Kontext sich die abzufragten Seiten befinden.
[in] VirtualAddress
Die Adresse des Bereichs der abzufragenden Seiten. Dieser Wert wird auf die nächste Hostseitenadressengrenze gerundet.
[in] MemoryInformationClass
Die Speicherinformationsklasse, über die Informationen abgerufen werden sollen. Der einzige unterstützte Wert ist MemoryRegionInfo.
[out] MemoryInformation
Ein Zeiger auf einen Puffer, der die angegebenen Informationen empfängt.
Wenn der Parameter MemoryInformationClass über den Wert MemoryRegionInfo verfügt, muss dieser Parameter auf eine WIN32_MEMORY_REGION_INFORMATION-Struktur verweisen.
[in] MemoryInformationSize
Gibt die Länge des Speicherinformationspuffers in Byte an.
[out, optional] ReturnSize
Ein optionaler Zeiger, der bei Angabe die Anzahl der Bytes empfängt, die im Speicherinformationspuffer platziert sind.
Rückgabewert
Gibt BEI Erfolg TRUE zurück. Gibt FALSE für Fehler zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Wenn der Parameter MemoryInformationClass über den Wert MemoryRegionInfo verfügt, muss der Parameter MemoryInformation auf eine WIN32_MEMORY_REGION_INFORMATION-Struktur verweisen. Der VirtualAddress-Parameter muss auf eine Adresse innerhalb einer gültigen Speicherbelegung verweisen. Wenn der VirtualAddress-Parameter auf einen nicht zugeordneten Speicherbereich verweist, schlägt die Funktion fehl.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1607 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | memoryapi.h (windows.h einschließen) |
| Bibliothek | Onecore.lib |
| DLL | Api-ms-win-core-memory-l1-1-4.dll |