MapViewOfFileNuma2-Funktion (memoryapi.h)

  • Artikel

Ordnet eine Ansicht einer Datei oder eines Auslagerungsabschnitts dem Adressraum des angegebenen Prozesses zu.

Syntax

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
);

Parameter

[in] FileMappingHandle

Ein HANDLE für einen Abschnitt, der dem Adressraum des angegebenen Prozesses zugeordnet werden soll.

[in] ProcessHandle

Ein HANDLE zu einem Prozess, dem der Abschnitt zugeordnet wird.

[in] Offset

Der Offset vom Anfang des Abschnitts. Dies muss 64.000 sein.

[in, optional] BaseAddress

Die gewünschte Basisadresse der Ansicht. Die Adresse wird auf die nächste 64k-Grenze gerundet. Wenn dieser Parameter NULL ist, wählt das System die Basisadresse aus.

[in] ViewSize

Die Anzahl der zuzuordnenden Bytes. Der Wert null (0) gibt an, dass der gesamte Abschnitt zugeordnet werden soll.

[in] AllocationType

Der Typ der Zuordnung. Dieser Parameter kann null (0) oder einer der folgenden konstanten Werte sein:

  • MEM_RESERVE : Ordnet eine reservierte Ansicht zu
  • MEM_LARGE_PAGES : Ordnet eine große Seitenansicht zu

[in] PageProtection

Der gewünschte Seitenschutz.

Bei Dateizuordnungsobjekten, die mit dem attribut SEC_IMAGE erstellt wurden, hat der PageProtection-Parameter keine Auswirkung und sollte auf einen gültigen Wert wie PAGE_READONLY festgelegt werden.

[in] PreferredNode

Der bevorzugte NUMA-Knoten für diesen Arbeitsspeicher.

Rückgabewert

Gibt bei erfolgreicher Ausführung die Basisadresse der zugeordneten Ansicht zurück. Andernfalls gibt NULL und erweiterter Fehler zurück, status mit GetLastError verfügbar ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1703 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2016 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile memoryapi.h (einschließlich Windows.h, Memoryapi.h)
Bibliothek Onecore.lib; Onecoreuap.lib
DLL Api-ms-win-core-memory-l1-1-5.dll

Weitere Informationen

MapViewOfFile

MapViewOfFileNuma