Funzione VirtualAlloc2FromApp (memoryapi.h)
Riserva, commit o modifica lo stato di un'area di pagine nello spazio degli indirizzi virtuali del processo chiamante. La memoria allocata da questa funzione viene inizializzata automaticamente su zero.
Usando questa funzione, è possibile: per le nuove allocazioni, specificare un intervallo di spazio indirizzi virtuale e una restrizione di allineamento power-of-2; specificare un numero arbitrario di parametri estesi; specificare un nodo NUMA preferito per la memoria fisica come parametro esteso; e specificare un'operazione segnaposto (in particolare, sostituzione).
Per specificare il nodo NUMA, vedere il parametro
Sintassi
PVOID VirtualAlloc2FromApp(
[in, optional] HANDLE Process,
[in, optional] PVOID BaseAddress,
[in] SIZE_T Size,
[in] ULONG AllocationType,
[in] ULONG PageProtection,
[in, out, optional] MEM_EXTENDED_PARAMETER *ExtendedParameters,
[in] ULONG ParameterCount
);
Parametri
[in, optional] Process
Handle di un processo. La funzione alloca memoria all'interno dello spazio indirizzi virtuale di questo processo.
L'handle deve avere il diritto di accesso PROCESS_VM_OPERATION. Per altre informazioni, vedere Process Security and Access Rights.
[in, optional] BaseAddress
Puntatore che specifica un indirizzo iniziale desiderato per l'area delle pagine da allocare.
Se baseAddress è null, la funzione determina dove allocare l'area.
Se baseAddress non è NULL, qualsiasi struttura di MEM_ADDRESS_REQUIREMENTS fornita deve essere costituita da tutti gli zeri e l'indirizzo di base deve essere un multiplo della granularità dell'allocazione di sistema. Per determinare la granularità dell'allocazione, usare la funzione GetSystemInfo
[in] Size
Dimensioni dell'area di memoria da allocare, in byte.
Le dimensioni devono essere sempre multiple delle dimensioni della pagina.
Se baseAddress non è null, la funzione alloca tutte le pagine contenenti uno o più byte nell'intervallo compreso tra baseAddress a BaseAddress+Size. Ciò significa, ad esempio, che un intervallo a 2 byte che si allontana da un limite di pagina fa sì che la funzione allochi entrambe le pagine.
[in] AllocationType
Tipo di allocazione di memoria. Questo parametro deve contenere uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
Alloca i costi di memoria (dalle dimensioni complessive della memoria e dei file di paging su disco) per le pagine di memoria riservate specificate. La funzione garantisce anche che quando il chiamante accede inizialmente alla memoria, il contenuto sarà zero. Le pagine fisiche effettive non vengono allocate a meno che/fino a quando non si accede effettivamente agli indirizzi virtuali.
Per riservare ed eseguire il commit delle pagine in un unico passaggio, chiamare Virtual2AllocFromApp con Il tentativo di eseguire il commit di un intervallo di indirizzi specifico specificando MEM_COMMIT senza MEM_RESERVE e unNULLBaseAddress ha esito negativo a meno che l'intero intervallo non sia già stato riservato. Il codice di errore risultante è ERROR_INVALID_ADDRESS. Un tentativo di eseguire il commit di una pagina già sottoposta a commit non causa l'esito negativo della funzione. Ciò significa che è possibile eseguire il commit delle pagine senza prima determinare lo stato di impegno corrente di ogni pagina. |
|
Riserva un intervallo di spazio indirizzi virtuale del processo senza allocare alcuna risorsa di archiviazione fisica effettiva in memoria o nel file di paging su disco.
È possibile eseguire il commit di pagine riservate nelle chiamate successive alla funzione Virtual2AllocFromApp. Per riservare ed eseguire il commit delle pagine in un unico passaggio, chiamare Virtual2AllocFromApp con MEM_COMMIT | MEM_RESERVE. Altre funzioni di allocazione della memoria, ad esempio malloc e LocalAlloc, non possono usare un intervallo di memoria riservato finché non viene rilasciato. |
|
Sostituisce un segnaposto con una normale allocazione privata. Sono supportate solo le visualizzazioni di sezione basate su dati/pf (nessuna immagine, memoria fisica e così via). Quando si sostituisce un segnaposto, baseAddress e dimensioni devono corrispondere esattamente a quelli del segnaposto e qualsiasi struttura MEM_ADDRESS_REQUIREMENTS fornita deve essere costituita da tutti gli zeri.
Dopo aver sostituito un segnaposto con un'allocazione privata, per liberare tale allocazione a un segnaposto, vedere il parametro Un segnaposto è un tipo di area di memoria riservata. |
|
Per creare un segnaposto, chiamare VirtualAlloc2 con MEM_RESERVE | MEM_RESERVE_PLACEHOLDER e PageProtection impostato su PAGE_NOACCESS. Per liberare/dividere/unire un segnaposto, vedere il parametro dwFreeType di VirtualFree e VirtualFreeEx.
Un segnaposto è un tipo di area di memoria riservata. |
|
Indica che i dati nell'intervallo di memoria specificato da baseAddress e dimensioni non sono più di interesse. Le pagine non devono essere lette o scritte nel file di paging. Tuttavia, il blocco di memoria verrà usato di nuovo in un secondo momento, quindi non deve essere decommesso. Questo valore non può essere utilizzato con altri valori.
L'utilizzo di questo valore non garantisce che l'intervallo utilizzato con MEM_RESET contenga zeri. Se si desidera che l'intervallo contenga zeri, decommettere la memoria e quindi ricommetterla. Quando si specifica MEM_RESET, la funzione Virtual2AllocFromApp ignora il valore di Protection. Tuttavia, è comunque necessario impostare Protection su un valore di protezione valido, ad esempio PAGE_NOACCESS. Virtual2AllocFromApp restituisce un errore se si usa MEM_RESET e l'intervallo di memoria viene mappato a un file. Una visualizzazione condivisa è accettabile solo se è mappata a un file di paging. |
|
MEM_RESET_UNDO deve essere chiamato solo su un intervallo di indirizzi a cui MEM_RESET è stato applicato correttamente in precedenza. Indica che i dati nell'intervallo di memoria specificato da baseAddress e Size sono di interesse per il chiamante e tentano di invertire gli effetti di MEM_RESET. Se la funzione ha esito positivo, significa che tutti i dati nell'intervallo di indirizzi specificato sono intatti. Se la funzione ha esito negativo, almeno alcuni dei dati nell'intervallo di indirizzi sono stati sostituiti con zere.
Questo valore non può essere utilizzato con altri valori. Se MEM_RESET_UNDO viene chiamato su un intervallo di indirizzi non MEM_RESET precedente, il comportamento non è definito. Quando si specifica MEM_RESET, la funzione Virtual2AllocFromApp ignora il valore di Protection. Tuttavia, è comunque necessario impostare Protection su un valore di protezione valido, ad esempio PAGE_NOACCESS. |
Questo parametro può anche specificare i valori seguenti, come indicato.
| Valore | Significato |
|---|---|
|
Alloca memoria usando supporto di pagine di grandi dimensioni.
Le dimensioni e l'allineamento devono essere un multiplo del minimo di pagina di grandi dimensioni. Per ottenere questo valore, usare la funzione GetLargePageMinimum. Se si specifica questo valore, è necessario specificare anche MEM_RESERVE e MEM_COMMIT. |
|
Riserva un intervallo di indirizzi che può essere utilizzato per eseguire il mapping pagine delle estensioni di finestra degli indirizzi (AWE).
Questo valore deve essere usato con MEM_RESERVE e nessun altro valore. |
|
Alloca la memoria al più alto indirizzo possibile. Questo può essere più lento rispetto alle allocazioni regolari, soprattutto quando sono presenti molte allocazioni. |
|
Fa sì che il sistema rintraccia le pagine scritte nell'area allocata. Se si specifica questo valore, è necessario specificare anche MEM_RESERVE.
Per recuperare gli indirizzi delle pagine scritte in dopo l'allocazione dell'area o la reimpostazione dello stato di rilevamento delle scritture, chiamare la funzione GetWriteWatch. Per reimpostare lo stato di rilevamento della scrittura, chiamare GetWriteWatch o ResetWriteWatch. La funzionalità di rilevamento delle scritture rimane abilitata per l'area di memoria fino a quando l'area non viene liberata. |
[in] PageProtection
Protezione della memoria per l'area delle pagine da allocare. Se viene eseguito il commit delle pagine, è possibile specificare una delle costanti di protezione della memoria . Le costanti seguenti generano un errore:
- PAGE_EXECUTE
- PAGE_EXECUTE_READ
- PAGE_EXECUTE_READWRITE
- PAGE_EXECUTE_WRITECOPY
[in, out, optional] ExtendedParameters
Puntatore facoltativo a uno o più parametri estesi di tipo MEM_EXTENDED_PARAMETER. Ognuno di questi valori di parametro estesi può avere un campo di type
[in] ParameterCount
Numero di parametri estesi a cui punta ExtendedParameters.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è l'indirizzo di base dell'area allocata delle pagine.
Se la funzione ha esito negativo, il valore restituito è NULL. Per ottenere informazioni estese sull'errore, chiamare GetLastError.
Osservazioni
Questa API consente di supportare giochi ad alte prestazioni e applicazioni server, che hanno requisiti specifici per la gestione dello spazio degli indirizzi virtuali. Ad esempio, mapping della memoria sopra un'area riservata in precedenza; ciò è utile per l'implementazione di un buffer circolare a capo automatico. E allocando memoria con allineamento specifico; ad esempio, per consentire all'applicazione di eseguire il commit su richiesta di aree mappate di pagine di grandi dimensioni o di grandi dimensioni.
Puoi chiamare Virtual2AllocFromApp dalle app di Windows Store con funzionalità JIT (Just-In-Time) per usare la funzionalità JIT. L'app deve includere la funzionalità codeGeneration nel file manifesto dell'app per usare le funzionalità JIT.
Ogni pagina ha uno stato di pagina associato. La funzione Virtual2AllocFromApp può eseguire le operazioni seguenti:
- Eseguire il commit di un'area di pagine riservate
- Riservare un'area di pagine gratuite
- Riservare ed eseguire il commit simultaneo di un'area di pagine gratuite
È possibile usare Virtual2AllocFromApp per riservare un blocco di pagine e quindi effettuare chiamate aggiuntive a Virtual2AllocFromApp per eseguire il commit di singole pagine dal blocco riservato. Ciò consente a un processo di riservare un intervallo di spazio indirizzi virtuale senza consumare spazio di archiviazione fisico fino a quando non è necessario.
Se il parametro baseAddress
Virtual2AllocFromApp non consente la creazione di pagine eseguibili.
La funzione Virtual2AllocFromApp
La funzione VirtualFree
Quando si crea un'area eseguibile, il programma chiamante è responsabile della coerenza della cache tramite una chiamata appropriata a FlushInstructionCache una volta impostato il codice. In caso contrario, i tentativi di eseguire codice dall'area appena eseguibile possono produrre risultati imprevedibili.
Esempi
Per esempi di codice, vedere Virtual2Alloc.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 10 [solo app desktop] |
| server minimo supportato | Windows Server 2016 [solo app desktop] |
| piattaforma di destinazione | Finestre |
| intestazione |
memoryapi.h (include Windows.h) |
| libreria |
WindowsApp.lib |
| dll | Kernel32.dll |
Vedere anche
funzioni di gestione della memoria