MapViewOfFile3FromApp-Funktion (memoryapi.h)
Ordnet eine Ansicht einer Dateizuordnung dem Adressraum einer aufrufenden Windows Store-App zu.
Mit dieser Funktion können Sie für neue Zuordnungen einen Bereich des virtuellen Adressraums und eine Power-of-2-Ausrichtungseinschränkung angeben. geben Sie eine beliebige Anzahl erweiterter Parameter an; geben Sie einen bevorzugten NUMA-Knoten für den physischen Speicher als erweiterten Parameter an; und geben einen Platzhaltervorgang an (insbesondere ersetzung).
Informationen zum Angeben des NUMA-Knotens finden Sie im ExtendedParameters-Parameter .
Syntax
PVOID MapViewOfFile3FromApp(
[in] HANDLE FileMapping,
[in] HANDLE Process,
[in, optional] PVOID BaseAddress,
[in] ULONG64 Offset,
[in] SIZE_T ViewSize,
[in] ULONG AllocationType,
[in] ULONG PageProtection,
[in, out, optional] MEM_EXTENDED_PARAMETER *ExtendedParameters,
[in] ULONG ParameterCount
);
Parameter
[in] FileMapping
Ein HANDLE für einen Abschnitt, der dem Adressraum des angegebenen Prozesses zugeordnet werden soll.
[in] Process
Ein HANDLE zu einem Prozess, dem der Abschnitt zugeordnet wird.
[in, optional] BaseAddress
Die gewünschte Basisadresse der Ansicht. Die Adresse wird auf die nächste 64k-Grenze gerundet.
If this parameter is <b>NULL</b>, the system picks the base
address.
Wenn BaseAddress nicht NULL ist, muss jede bereitgestellte MEM_ADDRESS_REQUIREMENTS-Struktur aus allen Nullen bestehen.
[in] Offset
Der Offset vom Anfang des Abschnitts. Dies muss 64.000 sein.
[in] ViewSize
Die Anzahl der zuzuordnenden Bytes. Der Wert null (0) gibt an, dass der gesamte Abschnitt zugeordnet werden soll.
Die Größe muss immer ein Vielfaches der Seitengröße sein.
[in] AllocationType
Der Typ der Speicherbelegung. Dieser Parameter kann null (0) oder einer der folgenden Werte sein.
| Wert | Bedeutung |
|---|---|
|
Ordnet eine reservierte Ansicht zu. |
|
Ersetzt einen Platzhalter durch eine zugeordnete Ansicht. Es werden nur daten-/pf-gesicherte Abschnittsansichten unterstützt (keine Bilder, physischer Arbeitsspeicher usw.). Wenn Sie einen Platzhalter ersetzen, müssen BaseAddress und ViewSize genau mit denen des Platzhalters übereinstimmen, und alle bereitgestellten MEM_ADDRESS_REQUIREMENTS-Struktur müssen aus allen Nullen bestehen.
Nachdem Sie einen Platzhalter durch eine zugeordnete Ansicht ersetzt haben, sehen Sie sich den UnmapFlags-Parameter von UnmapViewOfFileEx und UnmapViewOfFile2 an, um diese zugeordnete Ansicht wieder einem Platzhalter zu übergeben. Ein Platzhalter ist ein Typ des reservierten Speicherbereichs. |
|
Ordnet eine große Seitenansicht zu. Weitere Informationen finden Sie unter Unterstützung für große Seiten. |
[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, out, optional] ExtendedParameters
Ein optionaler Zeiger auf einen oder mehrere erweiterte Parameter vom Typ MEM_EXTENDED_PARAMETER. Jeder dieser erweiterten Parameterwerte kann selbst über ein Type-Feld von MemExtendedParameterAddressRequirements oder MemExtendedParameterNumaNode verfügen. Wenn kein erweiterter MemExtendedParameterNumaNode-Parameter bereitgestellt wird, ist das Verhalten dasselbe wie für die VirtualAlloc/MapViewOfFile-Funktionen (d. a. der bevorzugte NUMA-Knoten für die physischen Seiten wird basierend auf dem idealen Prozessor des Threads bestimmt, der zuerst auf den Arbeitsspeicher zugreift).
[in] ParameterCount
Die Anzahl der erweiterten Parameter, auf die von ExtendedParameters verwiesen wird.
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.
Bemerkungen
Diese API unterstützt Hochleistungsspiele und Serveranwendungen, die besondere Anforderungen an die Verwaltung ihres virtuellen Adressraums haben. Beispiel: Zuordnen des Arbeitsspeichers auf einer zuvor reservierten Region; Dies ist nützlich, um einen automatisch umschließenden Ringpuffer zu implementieren. Und Zuweisung von Arbeitsspeicher mit einer bestimmten Ausrichtung; beispielsweise, um Ihrer Anwendung zu ermöglichen, große/große seitenabbildete Regionen bei Bedarf zu committen.
Mit einer wichtigen Ausnahme sind Dateiansichten, die von einem Dateizuordnungsobjekt abgeleitet werden, das von derselben Datei unterstützt wird, kohärent oder zu einem bestimmten Zeitpunkt identisch. Die Kohärenz wird für Ansichten innerhalb eines Prozesses und für Sichten garantiert, die von verschiedenen Prozessen zugeordnet werden.
Die Ausnahme bezieht sich auf Remotedateien. MapViewOfFile3FromApp funktioniert zwar mit Remotedateien, hält sie jedoch nicht kohärent. Wenn z. B. zwei Computer eine Datei als schreibbar zuordnen und beide dieselbe Seite ändern, sieht jeder Computer nur seine eigenen Schreibvorgänge auf der Seite. Wenn die Daten auf dem Datenträger aktualisiert werden, werden sie nicht zusammengeführt.
Sie können nur erfolgreich schutz vor ausführbaren Dateien anfordern, wenn Ihre App über die funktion codeGeneration verfügt .
Beispiele
Ein Codebeispiel finden Sie unter Szenario 1 in Virtual2Alloc.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 10 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | memoryapi.h (windows.h einschließen) |
| Bibliothek | WindowsApp.lib |
| DLL | Kernel32.dll |