ZwMapViewOfSection 函式 (wdm.h)
ZwMapViewOfSection 例程會將區段的檢視對應至主旨程式的虛擬位址空間。
語法
NTSYSAPI NTSTATUS ZwMapViewOfSection(
[in] HANDLE SectionHandle,
[in] HANDLE ProcessHandle,
[in, out] PVOID *BaseAddress,
[in] ULONG_PTR ZeroBits,
[in] SIZE_T CommitSize,
[in, out, optional] PLARGE_INTEGER SectionOffset,
[in, out] PSIZE_T ViewSize,
[in] SECTION_INHERIT InheritDisposition,
[in] ULONG AllocationType,
[in] ULONG Win32Protect
);
參數
[in] SectionHandle
區段物件的句柄。 此句柄是由 成功呼叫 ZwCreateSection 或 ZwOpenSection 所建立。
[in] ProcessHandle
物件句柄，此物件表示檢視應該對應的進程。 使用 ZwCurrentProcess 宏來指定目前的進程。 句柄必須以 PROCESS_VM_OPERATION 存取權開啟。
[in, out] BaseAddress
接收檢視基位址之變數的指標。 如果此參數的值不是 NULL，則會從指定的虛擬位址四捨五入到下一個 64 KB 位址界限開始配置檢視。
[in] ZeroBits
指定區段檢視基地址中必須為零的高序位址位數目。 此參數的值必須小於 21，而且只有在 BaseAddress 為 NULL 時才使用，換句話說，當呼叫端允許系統判斷要配置檢視的位置時。
[in] CommitSize
指定檢視最初認可區域的大小，以位元組為單位。 CommitSize 只對頁面檔案支援的區段有意義，而且會四捨五入到最接近的多個PAGE_SIZE。 (針對對應檔案的區段，數據與影像都會在區段建立時認可。)
[in, out, optional] SectionOffset
從區段開頭到檢視之位移的變數指標，以位元組為單位。 如果這個指標不是 NULL，位移會四捨五入到下一個配置粒度大小界限。
[in, out] ViewSize
SIZE_T變數的指標。 如果這個變數的初始值為零， ZwMapViewOfSection 會對應從 SectionOffset 開始的區段檢視，並繼續到區段的結尾。 否則，初始值會以位元組為單位指定檢視的大小。 ZwMapViewOfSection 在對應檢視之前，一律會將此值四捨五入到最接近的PAGE_SIZE倍數。
傳回時，值會接收檢視的實際大小，以位元組為單位。
[in] InheritDisposition
指定如何與子進程共享檢視。 可能的值包括：
ViewShare
檢視將會對應到未來建立的任何子進程。
ViewUnmap
檢視不會對應到子進程。
驅動程式通常應該為此參數指定 ViewUnmap 。
[in] AllocationType
指定一組旗標，描述要針對指定頁面區域執行的配置類型。 有效的旗標是MEM_RESERVE、MEM_TOP_DOWN、MEM_LARGE_PAGES、MEM_DIFFERENT_IMAGE_BASE_OK和MEM_REPLACE_PLACEHOLDER。 雖然不允許MEM_COMMIT，除非指定MEM_RESERVE，否則會隱含。 如需MEM_XXX 旗標的詳細資訊，請參閱 VirtualAlloc 和 MapViewOfFile3 例程的描述。
[in] Win32Protect
指定要套用至對應檢視 的頁面保護 。
對於使用 SEC_IMAGE 屬性建立的 section 物件，Win32Protect 參數沒有任何作用，而且可以設定為任何有效的值，例如 PAGE_READONLY。
對於使用 SEC_IMAGE_NO_EXECUTE 屬性建立的區段物件，Win32Protect 值必須設定為 PAGE_READONLY。
對於非影像區段，Win32Protect 參數的值必須與呼叫 ZwCreateSection 時所指定的區段頁面保護相容。
ZwMapViewOfSection 會設定對應頁面的快取類型，以符合建立區段物件時所提供的快取類型。 例如，如果使用 SEC_NOCACHE 旗標呼叫 ZwCreateSection，則不論 Win32Protect 參數是否包含PAGE_NOCACHE旗標， ZwMapViewOfSection 都會對應未快取的頁面。
傳回值
ZwMapViewOfSection 會傳回 NTSTATUS 值。 可能的傳回值包括下列各項：
| 傳回碼 | Description |
|---|---|
| STATUS_SUCCESS | 例程已成功執行要求的作業。 |
| STATUS_CONFLICTING_ADDRESSES | 指定的位址範圍與已保留的範圍衝突。 |
| STATUS_INVALID_PAGE_PROTECTION | 為 Win32Protect 參數指定的值無效。 |
| STATUS_SECTION_PROTECTION | 為 Win32Protect 參數指定的值與建立區段時所指定的頁面保護不相容。 |
備註
區段的數個不同檢視可以同時對應至一或多個進程的虛擬位址空間。
請勿使用 ZwMapViewOfSection 將記憶體範圍從 \Device\PhysicalMemory 對應到使用者模式，除非您的驅動程式已透過 MmAllocatePagesForMdlEx 或另一種方法直接配置記憶體範圍，以確保沒有其他系統元件將相同的記憶體範圍對應至不同的 MEMORY_CACHING_TYPE 值。
使用者應用程式無法直接從 Windows Server 2003 Service Pack 1 (SP1) 存取 \Device\PhysicalMemory ，而且只有在驅動程式將句柄傳遞至應用程式時才能存取它。
如需區段對象的詳細資訊，請參閱 Section Objects and Views。
如果在使用者模式中呼叫此函式，您應該使用名稱 「NtMapViewOfSection」 而不是 「ZwMapViewOfSection」。。
針對來自內核模式驅動程式的呼叫，Windows 原生系統服務例程的 NtXxx 和 ZwXxx 版本會以處理和解譯輸入參數的方式，以不同的方式運作。 如需 例程 NtXxx 和 ZwXxx 版本之間關聯性的詳細資訊，請參閱 使用原生系統服務例程的 Nt 和 Zw 版本。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 合規性規則 | HwStorPortProhibitedDIS (storport) 、 PowerIrpDDis (wdm) |