Funzione MapViewOfFileNuma2 (memoryapi.h)

  • Articolo

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 MapViewOfFileNuma2(
  [in]           HANDLE  FileMappingHandle,
  [in]           HANDLE  ProcessHandle,
  [in]           ULONG64 Offset,
  [in, optional] PVOID   BaseAddress,
  [in]           SIZE_T  ViewSize,
  [in]           ULONG   AllocationType,
  [in]           ULONG   PageProtection,
  [in]           ULONG   PreferredNode
);

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.

[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 pagina di grandi dimensioni

[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.

[in] PreferredNode

Nodo NUMA preferito per questa memoria.

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.

Requisiti

Requisito Valore
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; Onecoreuap.lib
DLL Api-ms-win-core-memory-l1-1-5.dll

Vedi anche

MapViewOfFile

MapViewOfFileNuma