Funzione AllocateUserPhysicalPages2 (memoryapi.h)

Articolo
12/14/2023

Alloca le pagine di memoria fisica da mappare e annullare il mapping all'interno di qualsiasi area AWE (Address Windowing Extensions) di un processo specificato, con parametri estesi.

Sintassi

BOOL AllocateUserPhysicalPages2(
  [in]     HANDLE                  ObjectHandle,
  [in,out] PULONG_PTR              NumberOfPages,
  [out]    PULONG_PTR              PageArray,
  [in,out] PMEM_EXTENDED_PARAMETER ExtendedParameters,
  [in]     ULONG                   ExtendedParameterCount
);

Parametri

[in] ObjectHandle

Handle a un processo.

La funzione alloca memoria che può essere mappata in un secondo momento all'interno dello spazio indirizzi virtuale di questo processo. L'handle deve avere il diritto di accesso PROCESS_VM_OPERATION . Per altre informazioni, vedere Elaborare diritti di sicurezza e accesso.

[in,out] NumberOfPages

Dimensioni della memoria fisica da allocare nelle pagine.

Per determinare le dimensioni della pagina del computer, usare la funzione GetSystemInfo . In output, questo parametro riceve il numero di pagine effettivamente allocate, che potrebbero essere inferiori al numero richiesto.

[out] PageArray

Puntatore a una matrice per archiviare i numeri di frame di pagina della memoria allocata.

Le dimensioni della matrice allocata devono essere almeno il numeroOfPages volte le dimensioni del tipo di dati ULONG_PTR .

Non tentare di modificare questo buffer. Contiene dati del sistema operativo e il danneggiamento potrebbe essere irreversibile. Le informazioni nel buffer non sono utili per un'applicazione.

[in,out] ExtendedParameters

Puntatore a una matrice di strutture MEM_EXTENDED_PARAMETER .

[in] ExtendedParameterCount

Numero di MEM_EXTENDED_PARAMETER nella matrice ExtendedParameters .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

È possibile allocare meno pagine di quelle richieste. Il chiamante deve controllare il valore del parametro NumberOfPages in modo da visualizzare il numero di pagine allocato. Tutti i numeri di frame di pagina allocati vengono posizionati in sequenza nella memoria a cui punta il parametro UserPfnArray .

Se la funzione ha esito negativo, il valore restituito è FALSE e non vengono allocati fotogrammi. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

AllocateUserPhysicalPages2 è uguale a AllocateUserPhysicalPages, ma aggiunge i parametri ExtendedParameters e ExtendedParameterCount.

La funzione AllocateUserPhysicalPages2 viene usata per allocare memoria fisica che può essere mappata successivamente all'interno dello spazio indirizzi virtuale del processo. Il privilegio SeLockMemoryPrivilege deve essere abilitato nel token del chiamante o la funzione avrà esito negativo con ERROR_PRIVILEGE_NOT_HELD. Per altre informazioni, vedere Costanti dei privilegi.

La memoria allocata da questa funzione deve essere fisicamente presente nel sistema. Dopo l'allocazione della memoria, viene bloccato e non disponibile al resto del sistema di gestione della memoria virtuale.

Le pagine fisiche non possono essere mappate simultaneamente a più indirizzi virtuali.

Le pagine fisiche possono risiedere in qualsiasi indirizzo fisico. Non è consigliabile prendere presupposti sulla contiguità delle pagine fisiche.

Requisiti


Client minimo supportato	Windows 11, Build 20348
Server minimo supportato	Windows Server, Build 20348
Intestazione	memoryapi.h
Libreria	onecore.lib
DLL	kernelbase.dll