共用方式為


MapViewOfFileEx 函式 (memoryapi.h)

將檔案對應的檢視對應對應至呼叫進程的位址空間。 呼叫端可以選擇性地指定檢視的建議基底記憶體位址。

若要指定實體記憶體的 NUMA 節點,請參閱 MapViewOfFileExNuma

語法

LPVOID MapViewOfFileEx(
  [in]           HANDLE hFileMappingObject,
  [in]           DWORD  dwDesiredAccess,
  [in]           DWORD  dwFileOffsetHigh,
  [in]           DWORD  dwFileOffsetLow,
  [in]           SIZE_T dwNumberOfBytesToMap,
  [in, optional] LPVOID lpBaseAddress
);

參數

[in] hFileMappingObject

檔案對應物件的句柄。 CreateFileMappingOpenFileMapping 函式會傳回此句柄。

[in] dwDesiredAccess

檔案對應物件的存取類型,決定頁面的頁面保護。 此參數可以是下列其中一個值,或適當情況下多個值的位 OR 組合。

意義
FILE_MAP_ALL_ACCESS
檔案的讀取/寫入檢視已對應。 檔案對應對象必須使用 PAGE_READWRITEPAGE_EXECUTE_READWRITE 保護來建立。

搭配 MapViewOfFileEx 函式使用時, FILE_MAP_ALL_ACCESS 相當於 FILE_MAP_WRITE

FILE_MAP_READ
檔案的只讀檢視會對應。 嘗試寫入檔案檢視會導致存取違規。

檔案對應對象必須使用 PAGE_READONLYPAGE_READWRITEPAGE_EXECUTE_READPAGE_EXECUTE_READWRITE 保護來建立。

FILE_MAP_WRITE
檔案的讀取/寫入檢視已對應。 檔案對應對象必須使用 PAGE_READWRITEPAGE_EXECUTE_READWRITE 保護來建立。

搭配 MapViewOfFileEx 使用時, (FILE_MAP_WRITE | FILE_MAP_READ) FILE_MAP_ALL_ACCESS 相當於 FILE_MAP_WRITE

 

使用位 OR,您可以將上述值與這些值結合。

意義
FILE_MAP_COPY
檔案的複製寫入檢視會對應。 檔案對應對象必須使用PAGE_READONLYPAGE_READ_EXECUTE、PAGE_WRITECOPYPAGE_EXECUTE_WRITECOPYPAGE_READWRITEPAGE_EXECUTE_READWRITE保護來建立。

當行程寫入至寫入時,系統會將原始頁面複製到程式私用的新頁面。 新頁面是由分頁檔案所支援。 新頁面的保護會從寫入複製變更為讀取/寫入。

指定複製寫入存取權時,系統與進程認可會針對整個檢視收費,因為呼叫進程可能會寫入檢視中的每個頁面,讓所有頁面成為私人頁面。 新頁面的內容永遠不會寫回源檔,而且在檢視未對應時遺失。

FILE_MAP_LARGE_PAGES
從 Windows 10 1703 版開始,此旗標會指定應該使用大型頁面支援來對應檢視。 檢視的大小必須是 GetLargePageMinimum 函式所報告之大型頁面大小的倍數,而且必須使用 [SEC_LARGE_PAGES] 選項建立檔案對應物件。 如果您為 lpBaseAddress 提供非 Null 值,則此值必須是 GetLargePageMinimum 的倍數。
FILE_MAP_EXECUTE
檔案的可執行文件檢視會對應 (對應的記憶體可以執行為程式代碼) 。 檔案對應對象必須使用 PAGE_EXECUTE_READPAGE_EXECUTE_WRITECOPYPAGE_EXECUTE_READWRITE 保護來建立。

Windows Server 2003 和 Windows XP: 此值從 WINDOWS XP SP2 和 Windows Server 2003 SP1 開始可用。

FILE_MAP_TARGETS_INVALID
將對應檔案中的所有位置設定為控制流程防護 (CFG) 無效的目標。 此旗標類似於 PAGE_TARGETS_INVALID。 將此旗標與執行存取權搭配 使用FILE_MAP_EXECUTE。 對這些頁面中位置的任何間接呼叫都會失敗 CFG 檢查,而且程式將會終止。 配置之可執行文件頁面的預設行為是標示 CFG 的有效呼叫目標。
 

對於使用 SEC_IMAGE 屬性建立的檔案對應物件, dwDesiredAccess 參數沒有任何作用,而且應該設定為任何有效的值,例如 FILE_MAP_READ

如需檔案對應物件存取權的詳細資訊,請參閱 檔案對應安全性和訪問許可權

[in] dwFileOffsetHigh

要開始檢視之檔案位移的高序 DWORD

[in] dwFileOffsetLow

要開始檢視之檔案位移的低序 DWORD 。 高位移和低位移的組合必須在檔案對應中指定位移。 它們也必須符合系統的記憶體配置粒度。 也就是說,位移必須是配置粒度的倍數。 若要取得系統的記憶體配置粒度,請使用 GetSystemInfo 函式,以填入 SYSTEM_INFO 結構的成員。

[in] dwNumberOfBytesToMap

對應至檢視的檔案對應位元組數目。 所有位元組都必須在 CreateFileMapping 所指定的大小上限內。 如果此參數為 0 (零) ,則對應會從指定的位移延伸至檔案對應的結尾。

[in, optional] lpBaseAddress

呼叫行程位址空間中記憶體位址的指標,其中對應開始。 這必須是系統記憶體配置粒度的倍數,否則函式會失敗。 若要判斷系統的記憶體配置粒度,請使用 GetSystemInfo 函式。 如果指定位址的位址空間不足,函式會失敗。

如果 lpBaseAddressNULL,操作系統會選擇對應位址。 在此案例中,函式相當於 MapViewOfFile 函式

雖然您可以指定目前安全的位址, (操作系統) 未使用,但無法保證該位址在一段時間內會保持安全。 因此,最好讓操作系統選擇位址。 在此情況下,您不會將指標儲存在記憶體對應檔案中,您會儲存檔案對應基底的位移,以便在任何位址使用對應。

傳回值

如果函式成功,傳回值就是對應檢視的起始位址。

如果函式失敗,則傳回值為 NULL。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

對應檔案會使呼叫進程的位址空間中可見檔案的指定部分。

對於大於位址空間的檔案,您一次只能對應一小部分的檔案數據。 當第一個檢視完成時,您會取消對應並對應新的檢視。

若要取得檢視的大小,請使用 VirtualQueryEx 函式。

頁面檔案所支援之檔案對應對象中頁面的初始內容為 0 (零) 。

一般而言,建議的位址是用來指定檔案應該在多個進程中的相同地址對應。 這需要位址空間的區域可供所有涉及的進程使用。 無法在用於對應的區域中進行其他記憶體配置,包括使用 VirtualAllocVirtualAllocEx 函式來保留記憶體。

如果 lpBaseAddress 參數指定基底位移,則如果呼叫進程尚未使用指定的記憶體區域,函式就會成功。 系統不會確保其他32位進程中的記憶體對應檔案可以使用相同的記憶體區域。

檔案 (或檔案對應物件及其對應檔案的多個檢視,如果檔案在指定時間包含相同的數據,則其對應檔案) 是一致的 。 如果檔案檢視衍生自相同的檔案對應物件,就會發生這種情況。 進程可以使用 DuplicateHandle 函式將檔案對應物件句柄複製到另一個進程,或者另一個進程可以使用 OpenFileMapping 函式 依名稱開啟檔案對應物件。

有一個重要例外狀況,衍生自相同檔案所支援之任何檔案對應對象的檔案檢視在特定時間是一致或相同的。 對於進程內的檢視,以及由不同進程對應的檢視,保證一致性。

例外狀況與遠端檔案相關。 雖然 MapViewOfFileEx 可與遠端檔案搭配使用,但不會讓它們保持一致。 例如,如果兩部計算機將檔案對應為可寫入,而且兩部計算機都會變更相同的頁面,則每部計算機只會看到自己的頁面寫入。 當數據在磁碟上更新時,它不會合併。

檔案的對應檢視不保證與 ReadFileWriteFile 函式所存取的檔案一致。

若要防範 EXCEPTION_IN_PAGE_ERROR 例外狀況,請使用結構化例外狀況處理來保護寫入或讀取頁面檔案以外的檔案記憶體對應檢視的任何程序代碼。 如需詳細資訊,請參閱 從檔案檢視讀取和寫入

透過對應檢視修改檔案時,可能不會自動更新上次修改時間戳。 如有必要,呼叫端應該使用 SetFileTime 來設定時間戳。

若要擁有具有可執行檔許可權的檔案,應用程式必須使用 PAGE_EXECUTE_READWRITEPAGE_EXECUTE_READ 呼叫 CreateFileMapping,然後使用 FILE_MAP_EXECUTE | FILE_MAP_WRITEFILE_MAP_EXECUTE FILE_MAP_READ | 呼叫 MapViewOfFileEx

在 Windows Server 2012 中,下列技術支援此函式。

技術 支援
伺服器消息塊 (SMB) 3.0 通訊協定 Yes
SMB 3.0 透明故障轉移 (TFO) Yes
具有向外延展檔案共用的SMB 3.0 (SO) Yes
叢集共用磁碟區文件系統 (CsvFS) Yes
彈性檔案系統 (ReFS) Yes

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 memoryapi.h (包括 Windows.h、Memoryapi.h)
程式庫 onecore.lib
DLL Kernel32.dll

另請參閱

CreateFileMapping

建立檔案檢視

DuplicateHandle

檔案對應函式

GetSystemInfo

MapViewOfFileExNuma

OpenFileMapping

ReadFile

SYSTEM_INFO

UnmapViewOfFile

VirtualAlloc

WriteFile