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 位元組，再將其對應至系統記憶體。

規格需求

另請參閱

EngDeleteFile

EngUnmapFile