MapViewOfFile2-Funktion (memoryapi.h)

  • Artikel

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

Syntax

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

Parameter

[in] FileMappingHandle

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

[in] ProcessHandle

Ein HANDLE für einen Prozess, dem der Abschnitt zugeordnet wird. Das Handle muss über die PROCESS_VM_OPERATION Zugriffsmaske verfügen.

[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 Konstantenwerte sein:

  • MEM_RESERVE : Ordnet eine reservierte Ansicht zu.
  • MEM_LARGE_PAGES : Ordnet eine große Seitenansicht zu. Dieses Flag gibt an, dass die Ansicht mithilfe der Unterstützung für große Seiten zugeordnet werden soll. Die Größe der Ansicht muss ein Vielfaches der Größe einer großen Seite sein, die von der GetLargePageMinimum-Funktion gemeldet wird, und das Dateizuordnungsobjekt muss mit der Option SEC_LARGE_PAGES erstellt worden sein. Wenn Sie einen Wert ungleich NULL für den BaseAddress-Parameter angeben, muss der Wert ein Vielfaches von GetLargePageMinimum sein.

[in] PageProtection

Der gewünschte Seitenschutz.

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

Rückgabewert

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

Hinweise

Diese Funktion wird als Inlinefunktion im Header implementiert und ist in keiner Exportbibliothek oder DLL zu finden. Es ist identisch mit dem Aufrufen von MapViewOfFileNuma2 , wobei der letzte Parameter auf festgelegt ist NUMA_NO_PREFERRED_NODE.

Anforderungen

   
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
DLL Kernel32.dll

Siehe auch

MapViewOfFile

MapViewOfFileNuma2