virtualQuery 函式 (memoryapi.h)

發行項
02/28/2024

擷取呼叫進程虛擬位址空間中某個頁面範圍的相關信息。

若要擷取另一個進程位址空間中某個頁面範圍的相關信息，請使用 VirtualQueryEx 函式。

語法

SIZE_T VirtualQuery(
  [in, optional] LPCVOID                   lpAddress,
  [out]          PMEMORY_BASIC_INFORMATION lpBuffer,
  [in]           SIZE_T                    dwLength
);

參數

[in, optional] lpAddress

要查詢之頁面區域的基位址指標。此值會進位至下一個頁面界限。若要判斷主計算機上的頁面大小，請使用 GetSystemInfo 函式。

如果 lpAddress 指定進程可存取的最高記憶體位址上方的位址，則函式會失敗並 ERROR_INVALID_PARAMETER。

[out] lpBuffer

MEMORY_BASIC_INFORMATION 結構的指標，其中會傳回指定之頁面範圍的相關信息。

[in] dwLength

lpBuffer 參數所指向的緩衝區大小，以位元組為單位。

傳回值

傳回值是信息緩衝區中傳回的實際位元組數目。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。可能的錯誤值包括 ERROR_INVALID_PARAMETER。

備註

VirtualQuery 提供連續頁面區域的相關信息，從共用下列屬性的指定地址開始：

所有頁面的狀態都相同 (MEM_COMMIT、MEM_RESERVE、MEM_FREE、MEM_PRIVATE、MEM_MAPPED或MEM_IMAGE) 。
如果初始頁面沒有可用，區域中的所有頁面都是由單一呼叫 VirtualAlloc、MapViewOfFile 或下列其中一個擴充版本的這些函式所建立的相同初始配置頁面：VirtualAllocEx、VirtualAllocExNuma、MapViewOfFileEx、MapViewOfFileExNuma。
授與所有頁面的存取權是相同的 (PAGE_READONLY、PAGE_READWRITE、PAGE_NOACCESS、PAGE_WRITECOPY、PAGE_EXECUTE、PAGE_EXECUTE_READ、PAGE_EXECUTE_READWRITE、PAGE_EXECUTE_WRITECOPY、PAGE_GUARD或PAGE_NOCACHE) 。

函式會決定區域中第一頁的屬性，然後掃描後續頁面，直到掃描整個頁面範圍，或直到遇到具有一組不相符屬性的頁面為止。函式會以位元組為單位傳回具有相符屬性的頁面區域屬性和大小。例如，如果可用記憶體的頁面上有 40 MB (MB) 區域，而且在 10 MB 的區域中呼叫 VirtualQuery ，則函式會取得 MEM_FREE 狀態，且大小為 30 MB。

如果修改了寫入時共用複本頁面，它就會變成修改頁面的程式私用。不過，VirtualQuery 函式會繼續針對數據檢視 ) MEM_MAPPED ( 或可執行檔影像檢視) MEM_IMAGE (等頁面，而不是MEM_PRIVATE。若要偵測特定頁面是否已發生寫入複製，請使用 VirtualLock 函式來存取頁面，或使用 VirtualLock 函式鎖定頁面，以確定頁面位於記憶體中，然後使用 QueryWorkingSetEx 函式來檢查頁面擴充工作集資訊中的共用位。如果共用位已清除，則頁面為私人。

此函式會報告呼叫進程記憶體中頁面的區域，而 VirtualQueryEx 函式會報告指定進程記憶體中頁面的區域。

規格需求

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