EngMapFile-Funktion (winddi.h)

  • Artikel
  • 2 Minuten Lesedauer

Die Funktion EngMapFile 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-beendete 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

Zeigen Sie auf einen Speicherspeicherort, der einen Bezeichner für die zugeordnete Datei empfängt, sofern die Zuordnung erfolgreich war. Wenn die Zuordnung nicht erfolgreich war, erhält der Speicherspeicherort den Wert Null. 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 und ordnet sie lese-/schreibzugriff zu.

Der Wert von cjSize wirkt sich auf die Zuordnung der Datei wie folgt 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 in größe, bevor sie im Systemspeicher zugeordnet werden. Es sollten keine Annahmen über den Inhalt des Arbeitsspeichers vorgenommen 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 der Größe zu cjSize zu verkleinern , bevor sie in den Systemspeicher zugeordnet werden.
Ein Treiber kann die Datei über den zurückgegebenen Zeiger lesen und schreiben.

Anforderungen

   
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