共用方式為

EngMapFile 函式 (winddi.h)

  • 發行項

EngMapFile 函式會建立或開啟檔案，並將其對應至系統空間。

語法

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

參數

[in] pwsz

Null 終止字串的指標，其中包含要對應之檔案的完整名稱。 完整檔名字串的範例是 L“\？？\c：\test.dat”。

[in] cjSize

指定要對應的檔案位元組數目。

[out] piFile

當對應成功時，接收對應檔案標識符的記憶體位置指標。 如果對應失敗，則記憶體位置會收到零值。 需要釋放對應的檔案時，此值應該傳遞至 EngUnmapFile。

傳回值

如果檔案成功，EngMapFile 會傳回檔案對應檢視的指標。 否則會傳回 NULL。

備註

如果檔案已經存在， EngMapFile 會開啟並對應它以供讀取/寫入。 如果檔案不存在， EngMapFile 會建立並對應它以供讀取/寫入。

cjSize 的值會影響檔案的對應，如下所示：

  • 當 cjSize 為零時，GDI 會完整對應檔案。
  • 當 cjSize 大於檔案的大小時，GDI 會將檔案擴充為 cjSize 位元組，再將其對應到系統記憶體中。 不應假設記憶體的內容超出檔案的原始大小。
  • 當 cjSize 小於檔案的大小時，GDI 會將檔案截斷為 cjSize 位元組，再將其對應至系統記憶體。
驅動程式可以透過傳回的指標讀取和寫入檔案。

規格需求

需求 值
最低支援的用戶端 適用於 Windows 2000 和更新版本的 Windows 作業系統。
目標平台 Universal
標頭 winddi.h (包含Winddi.h)
程式庫 Win32k.lib
Dll Win32k.sys

另請參閱

EngDeleteFile

EngUnmapFile