MapViewOfFile2-Funktion (memoryapi.h)
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 |