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

Weitere Informationen

GetLastError

MEMORY_BASIC_INFORMATION

WIN32_MEMORY_REGION_INFORMATION