AllocateUserPhysicalPagesNuma-Funktion (memoryapi.h)
Weist physische Speicherseiten zu, die innerhalb eines AWE-Bereichs ( Address Windowing Extensions ) eines angegebenen Prozesses zugeordnet und nicht zugeordnet werden sollen, und gibt den NUMA-Knoten für den physischen Speicher an.
Syntax
BOOL AllocateUserPhysicalPagesNuma(
[in] HANDLE hProcess,
[in, out] PULONG_PTR NumberOfPages,
[out] PULONG_PTR PageArray,
[in] DWORD nndPreferred
);
Parameter
[in] hProcess
Ein Handle für einen Prozess.
Die Funktion ordnet Arbeitsspeicher zu, der später innerhalb des virtuellen Adressraums dieses Prozesses zugeordnet werden kann. Das Handle muss über das zugriffsrecht PROCESS_VM_OPERATION verfügen. Weitere Informationen finden Sie unter Prozesssicherheit und Zugriffsrechte.
[in, out] NumberOfPages
Die Größe des zuzuordnenden physischen Speichers in Seiten.
Verwenden Sie die GetSystemInfo-Funktion , um die Seitengröße des Computers zu bestimmen. Bei der Ausgabe empfängt dieser Parameter die Anzahl der tatsächlich zugeordneten Seiten, die kleiner als die angeforderte Zahl sein kann.
[out] PageArray
Ein Zeiger auf ein Array zum Speichern der Seitenrahmennummern des zugeordneten Arbeitsspeichers.
Die Größe des zugeordneten Arrays sollte mindestens dem NumberOfPages-Mal der Größe des ULONG_PTR-Datentyps entspricht.
[in] nndPreferred
Der NUMA-Knoten, auf dem sich der physische Arbeitsspeicher befinden soll.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.
Es können weniger Seiten als angefordert zugeordnet werden. Der Aufrufer muss den Wert des NumberOfPages-Parameters bei der Rückgabe überprüfen, um zu sehen, wie viele Seiten zugeordnet sind. Alle zugeordneten Seitenrahmennummern werden sequenziell im Speicher platziert, auf den der PageArray-Parameter verweist.
Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE , und es werden keine Frames zugeordnet. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie die GetLastError-Funktion auf.
Hinweise
Die AllocateUserPhysicalPagesNuma-Funktion wird verwendet, um physischen Arbeitsspeicher innerhalb eines NUMA-Knotens zuzuweisen, der später innerhalb des virtuellen Adressraums des Prozesses zugeordnet werden kann. Die SeLockMemoryPrivilege-Berechtigung muss im Token des Aufrufers aktiviert sein, andernfalls schlägt die Funktion mit ERROR_PRIVILEGE_NOT_HELD fehl. Weitere Informationen finden Sie unter Berechtigungskonstanten.
Der von dieser Funktion zugeordnete Arbeitsspeicher muss physisch im System vorhanden sein. Nachdem der Arbeitsspeicher zugeordnet wurde, ist er gesperrt und für den Rest des virtuellen Speicherverwaltungssystems nicht mehr verfügbar.
Physische Seiten können nicht gleichzeitig an mehr als einer virtuellen Adresse zugeordnet werden.
Physische Seiten können sich an jeder physischen Adresse befinden. Sie sollten keine Annahmen über die Kontinuität der physischen Seiten treffen.
Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0600 oder höher.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | memoryapi.h (einschließlich Windows.h, Memoryapi.h) |
| Bibliothek | onecore.lib |
| DLL | Kernel32.dll |