VirtualAlloc-Funktion (memoryapi.h)

Reserviert, commits oder ändert den Status eines Seitenbereichs im virtuellen Adressraum des aufrufenden Prozesses. Der von dieser Funktion zugewiesene Arbeitsspeicher wird automatisch auf Null initialisiert.

Verwenden Sie die VirtualAllocEx--Funktion, um Speicher im Adressraum eines anderen Prozesses zuzuweisen.

Syntax

LPVOID VirtualAlloc(
  [in, optional] LPVOID lpAddress,
  [in]           SIZE_T dwSize,
  [in]           DWORD  flAllocationType,
  [in]           DWORD  flProtect
);

Parameter

[in, optional] lpAddress

Die Startadresse der Region, die zugewiesen werden soll. Wenn der Speicher reserviert wird, wird die angegebene Adresse auf das nächste Vielfache der Zuordnungs granularität aufgerundet. Wenn der Speicher bereits reserviert ist und ein Commit ausgeführt wird, wird die Adresse auf die nächste Seitengrenze abgerundet. Um die Größe einer Seite und die Zuordnungs granularität auf dem Hostcomputer zu bestimmen, verwenden Sie die GetSystemInfo--Funktion. Wenn dieser Parameter NULL-ist, bestimmt das System, wo die Region zugeordnet werden soll.

Wenn sich diese Adresse in einer Enklave befindet, die Sie nicht initialisiert haben, indem Sie InitializeEnklaveaufrufen, VirtualAlloc eine Seite mit Nullen für die Enklave an dieser Adresse zuweist. Die Seite muss zuvor nicht ausgelassen werden und wird nicht mit der EEXTEND-Anweisung des Intel Software Guard Extensions-Programmiermodells gemessen.

Wenn sich die Adresse in einer Enklave befindet, die Sie initialisiert haben, schlägt der Zuordnungsvorgang mit dem ERROR_INVALID_ADDRESS Fehler fehl. Das gilt für Enklaven, die keine dynamische Speicherverwaltung unterstützen (d. h. SGX1). SGX2-Enklaven erlauben die Zuordnung, und die Seite muss von der Enklave akzeptiert werden, nachdem sie zugeteilt wurde.

[in] dwSize

Die Größe des Bereichs in Byte. Wenn der parameter lpAddressNULList, wird dieser Wert auf die nächste Seitengrenze aufgerundet. Andernfalls enthalten die zugeordneten Seiten alle Seiten mit mindestens einem Byte im Bereich von lpAddress bis lpAddress+dwSize. Dies bedeutet, dass ein 2-Byte-Bereich, der eine Seitengrenze überspannt, bewirkt, dass beide Seiten in den zugeordneten Bereich eingeschlossen werden.

[in] flAllocationType

Der Typ der Speicherzuweisung. Dieser Parameter muss einen der folgenden Werte enthalten.

Dieser Parameter kann auch die folgenden Werte wie angegeben angeben.

[in] flProtect

Der Speicherschutz für den Bereich der zuzuordnenden Seiten. Wenn die Seiten zugesichert werden, können Sie eine der Speicherschutzkonstantenangeben.

Wenn lpAddress- eine Adresse innerhalb einer Enklave angibt, kann flProtect keine der folgenden Werte sein:

• PAGE_NOACCESS
• PAGE_GUARD
• PAGE_NOCACHE
• PAGE_WRITECOMBINE

Beim Zuweisen des dynamischen Speichers für eine Enklave muss der parameter flProtectPAGE_READWRITE oder PAGE_EXECUTE_READWRITEsein.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Basisadresse des zugeordneten Seitenbereichs.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Jede Seite verfügt über einen zugeordneten Seitenzustand. Die funktion VirtualAlloc kann die folgenden Vorgänge ausführen:

• Übernehmen eines Bereichs reservierter Seiten
• Reservieren einer Region mit kostenlosen Seiten
• Gleichzeitiges Reservieren und Übernehmen einer Region kostenloser Seiten

VirtualAlloc kann keine reservierte Seite reservieren. Sie kann eine Seite übernehmen, die bereits zugesichert ist. Dies bedeutet, dass Sie einen Seitenbereich übernehmen können, unabhängig davon, ob sie bereits zugesichert wurden, und die Funktion schlägt nicht fehl.

Sie können VirtualAlloc- verwenden, um einen Seitenblock zu reservieren und dann zusätzliche Aufrufe an VirtualAlloc vorzunehmen, um einzelne Seiten aus dem reservierten Block zu übernehmen. Dadurch kann ein Prozess einen Bereich seines virtuellen Adressraums reservieren, ohne physischen Speicher zu verbrauchen, bis er benötigt wird.

Wenn der parameter lpAddress nicht NULList, verwendet die Funktion die lpAddress und dwSize Parameter, um den bereich der zuzuordnenden Seiten zu berechnen. Der aktuelle Zustand des gesamten Seitenbereichs muss mit dem Typ der Zuordnung kompatibel sein, die vom flAllocationType Parameter angegeben wurde. Andernfalls schlägt die Funktion fehl, und keiner der Seiten wird zugewiesen. Diese Kompatibilitätsanforderung schließt das Commit einer bereits zugesicherten Seite nicht aus, wie zuvor erwähnt.

Um dynamisch generierten Code auszuführen, verwenden Sie VirtualAlloc-, um Arbeitsspeicher und die VirtualProtect--Funktion zuzuweisen, um PAGE_EXECUTE Zugriff zu gewähren.

Die VirtualAlloc-Funktion kann verwendet werden, um eine Adressfenstererweiterungen (AWE)-Bereich des Arbeitsspeichers innerhalb des virtuellen Adressraums eines angegebenen Prozesses zu reservieren. Dieser Speicherbereich kann dann verwendet werden, um physische Seiten nach Bedarf der Anwendung in und außerhalb des virtuellen Arbeitsspeichers zuzuordnen. Die werte MEM_PHYSICAL und MEM_RESERVE müssen im parameter AllocationType festgelegt werden. Der wert MEM_COMMIT darf nicht festgelegt werden. Der Seitenschutz muss auf PAGE_READWRITEfestgelegt werden.

Die funktion VirtualFree kann eine zugesicherte Seite aufheben, den Speicher der Seite freigeben oder gleichzeitig eine zugesicherte Seite aufheben und freigeben. Sie kann auch eine reservierte Seite freigeben, wodurch sie eine kostenlose Seite wird.

Beim Erstellen einer Region, die ausführbar ist, trägt das aufrufende Programm die Verantwortung für die Sicherstellung der Cachekohärenz über einen entsprechenden Aufruf von FlushInstructionCache, nachdem der Code eingerichtet wurde. Andernfalls kann der Versuch, Code aus dem neu ausführbaren Bereich auszuführen, zu unvorhersehbaren Ergebnissen führen.

Beispiele

Ein Beispiel finden Sie unter Reserving and Commit memory.

Anforderungen

Siehe auch

Speicherverwaltungsfunktionen

virtuelle Speicherfunktionen

VirtualAllocEx-

VirtualFree

VirtualLock-

VirtualProtect-

VirtualQuery-

Vertdll-APIs in VBS-Enklaven