Funzione MapViewOfFile2 (memoryapi.h)

Articolo
08/24/2023

Esegue il mapping di una visualizzazione di un file o di una sezione del file di pagina supportata nello spazio indirizzi del processo specificato.

Sintassi

PVOID MapViewOfFile2(
  [in]           HANDLE  FileMappingHandle,
  [in]           HANDLE  ProcessHandle,
  [in]           ULONG64 Offset,
  [in, optional] PVOID   BaseAddress,
  [in]           SIZE_T  ViewSize,
  [in]           ULONG   AllocationType,
  [in]           ULONG   PageProtection
);

Parametri

[in] FileMappingHandle

Handle a una sezione che deve essere mappata nello spazio indirizzi del processo specificato.

[in] ProcessHandle

Handle a un processo in cui verrà eseguito il mapping della sezione. L'handle deve avere la maschera di accesso PROCESS_VM_OPERATION .

[in] Offset

Offset dall'inizio della sezione. Questo deve essere allineato a 64k.

[in, optional] BaseAddress

Indirizzo di base desiderato della visualizzazione. L'indirizzo viene arrotondato fino al limite più vicino a 64k. Se questo parametro è NULL, il sistema seleziona l'indirizzo di base.

[in] ViewSize

Numero di byte da mappare. Un valore pari a zero (0) specifica che l'intera sezione deve essere mappata.

[in] AllocationType

Tipo di allocazione. Questo parametro può essere zero (0) o uno dei valori costanti seguenti:

MEM_RESERVE : esegue il mapping di una visualizzazione riservata.
MEM_LARGE_PAGES : esegue il mapping di una visualizzazione di pagina di grandi dimensioni. Questo flag specifica che la visualizzazione deve essere mappata usando il supporto di pagine di grandi dimensioni. Le dimensioni della visualizzazione devono essere multiple delle dimensioni di una pagina di grandi dimensioni segnalate dalla funzione GetLargePageMinimum e l'oggetto mapping file deve essere stato creato usando l'opzione SEC_LARGE_PAGES . Se si specifica un valore non Null per il parametro BaseAddress , il valore deve essere un multiplo di GetLargePageMinimum.

[in] PageProtection

Protezione della pagina desiderata.

Per gli oggetti di mapping dei file creati con l'attributo SEC_IMAGE , il parametro PageProtection non ha alcun effetto e deve essere impostato su qualsiasi valore valido, ad esempio PAGE_READONLY.

Valore restituito

Restituisce l'indirizzo di base della visualizzazione mappata, se riuscito. In caso contrario, restituisce lo stato di errore NULL e esteso è disponibile usando GetLastError.

Commenti

Questa funzione viene implementata come funzione inline nell'intestazione e non è disponibile in alcuna libreria di esportazione o DLL. È uguale a chiamare MapViewOfFileNuma2 con l'ultimo parametro impostato su NUMA_NO_PREFERRED_NODE.

Requisiti


Client minimo supportato	Windows 10 versione 1703 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	memoryapi.h (includono Windows.h, Memoryapi.h)
Libreria	onecore.lib
DLL	Kernel32.dll

Vedere anche

MapViewOfFile

MapViewOfFileNuma2

Condividi tramite