EngMapFile-Funktion (winddi.h)

  • Artikel

Die EngMapFile-Funktion erstellt oder öffnet eine Datei und ordnet sie dem Systembereich zu.

Syntax

ENGAPI PVOID EngMapFile(
  [in]  LPWSTR    pwsz,
  [in]  ULONG     cjSize,
  [out] ULONG_PTR *piFile
);

Parameter

[in] pwsz

Zeiger auf eine NULL-endende Zeichenfolge, die den vollqualifizierten Namen der zuzuordnenden Datei enthält. Ein Beispiel für eine vollqualifizierte Dateinamenzeichenfolge ist L"\?? \c:\test.dat".

[in] cjSize

Gibt die Anzahl der Bytes der zuzuordnenden Datei an.

[out] piFile

Zeiger auf einen Speicherort, der einen Bezeichner für die zugeordnete Datei empfängt, sofern die Zuordnung erfolgreich war. Wenn die Zuordnung nicht erfolgreich war, erhält der Speicherort des Arbeitsspeichers den Wert 0 . Wenn die zugeordnete Datei freigegeben werden muss, sollte dieser Wert an EngUnmapFile übergeben werden.

Rückgabewert

EngMapFile gibt einen Zeiger auf die zugeordnete Ansicht der Datei zurück, wenn sie erfolgreich ist. Andernfalls wird NULL zurückgegeben.

Hinweise

Wenn die Datei bereits vorhanden ist, wird EngMapFile geöffnet und für Lese-/Schreibzugriff zugeordnet. Wenn die Datei nicht vorhanden ist, erstellt EngMapFile sie für Lese-/Schreibzugriff und ordnet sie zu.

Der Wert von cjSize wirkt sich wie folgt auf die Zuordnung der Datei aus:

  • Wenn cjSize null ist, ordnet GDI die Datei vollständig zu.
  • Wenn cjSize größer als die Größe der Datei ist, erweitert GDI die Datei auf cjSize Bytes, bevor sie im Systemspeicher zugeordnet wird. Es sollten keine Annahmen über den Inhalt des Arbeitsspeichers getroffen werden, der über die ursprüngliche Größe der Datei hinausgeht.
  • Wenn cjSize kleiner als die Größe der Datei ist, schneidet GDI die Datei ab, um bytes in cjSize zu skalieren , bevor sie dem Systemspeicher zugeordnet wird.
Ein Treiber kann die Datei über den zurückgegebenen Zeiger lesen und in die Datei schreiben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Universell
Header winddi.h (einschließlich Winddi.h)
Bibliothek Win32k.lib
DLL Win32k.sys

Weitere Informationen

EngDeleteFile

EngUnmapFile