Fungsi EngMapFile (winddi.h)

Artikel
08/27/2023

Fungsi EngMapFile membuat atau membuka file dan memetakannya ke ruang sistem.

Sintaks

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

Parameter

[in] pwsz

Penunjuk ke string yang dihentikan null yang berisi nama file yang sepenuhnya memenuhi syarat untuk dipetakan. Contoh string nama file yang sepenuhnya memenuhi syarat adalah L"\?? \c:\test.dat".

[in] cjSize

Menentukan jumlah byte file yang akan dipetakan.

[out] piFile

Penunjuk ke lokasi memori yang menerima pengidentifikasi untuk file yang dipetakan, asalkan pemetaan berhasil. Jika pemetaan tidak berhasil, lokasi memori menerima nilai nol. Ketika file yang dipetakan perlu dirilis, nilai ini harus diteruskan ke EngUnmapFile.

Nilai kembali

EngMapFile mengembalikan pointer ke tampilan file yang dipetakan jika berhasil. Jika tidak, ia mengembalikan NULL.

Keterangan

Jika file sudah ada, EngMapFile membuka dan memetakannya untuk dibaca/ditulis. Jika file tidak ada, EngMapFile membuat dan memetakannya untuk dibaca/ditulis.

Nilai cjSize memengaruhi pemetaan file sebagai berikut:

Ketika cjSize nol, GDI memetakan file secara keseluruhan.
Ketika cjSize lebih besar dari ukuran file, GDI memperluas file ke ukuran byte cjSize sebelum memetakannya dalam memori sistem. Tidak ada asumsi yang harus dibuat tentang konten memori yang melampaui ukuran asli file.
Ketika cjSize kurang dari ukuran file, GDI memotong file ke ukuran byte cjSize sebelum memetakannya ke dalam memori sistem.

Driver dapat membaca dan menulis ke file melalui penunjuk yang dikembalikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Universal
Header	winddi.h (termasuk Winddi.h)
Pustaka	Win32k.lib
DLL	Win32k.sys

Lihat juga

EngDeleteFile

EngUnmapFile

Bagikan melalui