共用方式為

PSS_CAPTURE_FLAGS列舉 (processsnapshot.h)

  • 發行項

指定 PssCaptureSnapshot 擷取的旗標。

Syntax

typedef enum {
  PSS_CAPTURE_NONE = 0x00000000,
  PSS_CAPTURE_VA_CLONE = 0x00000001,
  PSS_CAPTURE_RESERVED_00000002 = 0x00000002,
  PSS_CAPTURE_HANDLES = 0x00000004,
  PSS_CAPTURE_HANDLE_NAME_INFORMATION = 0x00000008,
  PSS_CAPTURE_HANDLE_BASIC_INFORMATION = 0x00000010,
  PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION = 0x00000020,
  PSS_CAPTURE_HANDLE_TRACE = 0x00000040,
  PSS_CAPTURE_THREADS = 0x00000080,
  PSS_CAPTURE_THREAD_CONTEXT = 0x00000100,
  PSS_CAPTURE_THREAD_CONTEXT_EXTENDED = 0x00000200,
  PSS_CAPTURE_RESERVED_00000400 = 0x00000400,
  PSS_CAPTURE_VA_SPACE = 0x00000800,
  PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION = 0x00001000,
  PSS_CAPTURE_IPT_TRACE = 0x00002000,
  PSS_CAPTURE_RESERVED_00004000,
  PSS_CREATE_BREAKAWAY_OPTIONAL = 0x04000000,
  PSS_CREATE_BREAKAWAY = 0x08000000,
  PSS_CREATE_FORCE_BREAKAWAY = 0x10000000,
  PSS_CREATE_USE_VM_ALLOCATIONS = 0x20000000,
  PSS_CREATE_MEASURE_PERFORMANCE = 0x40000000,
  PSS_CREATE_RELEASE_SECTION = 0x80000000
} PSS_CAPTURE_FLAGS;

常數

 
PSS_CAPTURE_NONE
值： 0x00000000
不擷取任何專案
PSS_CAPTURE_VA_CLONE
值： 0x00000001
擷取程式中所有可複製頁面的快照集。 複製品包含所有 MEM_PRIVATE 區域，以及可共用的所有區段 (MEM_MAPPED 和 MEM_IMAGE) 。 透過 CreateFileMapping 建立的所有 Win32 區段都可共用。
PSS_CAPTURE_RESERVED_00000002
值： 0x00000002
(請勿使用.)
PSS_CAPTURE_HANDLES
值： 0x00000004
只擷取句柄數據表 (句柄值) 。
PSS_CAPTURE_HANDLE_NAME_INFORMATION
值： 0x00000008
擷取每個句柄的名稱資訊。
PSS_CAPTURE_HANDLE_BASIC_INFORMATION
值： 0x00000010
擷取基本句柄資訊，例如 HandleCount、 PointerCount、 GrantedAccess 等。
PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION
值： 0x00000020
針對支持的物件類型擷取類型特定資訊： Process、 Thread、 Event、 Mutant、 Section。
PSS_CAPTURE_HANDLE_TRACE
值： 0x00000040
擷取句柄追蹤數據表。
PSS_CAPTURE_THREADS
值： 0x00000080
僅擷取線程資訊 (標識碼) 。
PSS_CAPTURE_THREAD_CONTEXT
值： 0x00000100
擷取每個線程的內容。
PSS_CAPTURE_THREAD_CONTEXT_EXTENDED
值： 0x00000200
擷取每個線程的擴充內容 (例如 CONTEXT_XSTATE) 。
PSS_CAPTURE_RESERVED_00000400
值： 0x00000400
(請勿使用.)
PSS_CAPTURE_VA_SPACE
值： 0x00000800
擷取虛擬位址空間的快照集。 VA 空間會擷取為 MEMORY_BASIC_INFORMATION 結構的陣列。 此旗標不會擷取頁面的內容。
PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION
值： 0x00001000
針對 MEM_IMAGE 和 MEM_MAPPED 區域，會將檔案的路徑傾印到支援區段的路徑， (與 GetMappedFileName 傳回) 相同。 針對 MEM_IMAGE 區域，也會傾印：



  • IMAGE_NT_HEADERS。FileHeader.TimeDateStamp



  • IMAGE_NT_HEADERS。OptionalHeader.SizeOfImage



  • IMAGE_NT_HEADERS。OptionalHeader.ImageBase



  • IMAGE_NT_HEADERS。OptionalHeader.CheckSum



進程句柄上需要PROCESS_VM_READ訪問許可權。

警告 只有在指定 PSS_CAPTURE_VA_SPACE 時，此選項才有效。

 
PSS_CAPTURE_IPT_TRACE
值： 0x00002000
PSS_CREATE_BREAKAWAY_OPTIONAL
值： 0x04000000
斷點是選擇性的。 如果複製程式無法建立為中斷專案，則會在作業內建立它。 這個旗標必須與 PSS_CREATE_FORCE_BREAKAWAY 和/或 PSS_CREATE_BREAKAWAY搭配指定。
PSS_CREATE_BREAKAWAY
值： 0x08000000
複製品會與父進程的工作中斷。 這相當於 CreateProcess 旗 標CREATE_BREAKAWAY_FROM_JOB。
PSS_CREATE_FORCE_BREAKAWAY
值： 0x10000000
複製品會強制中斷父進程的工作。 這僅適用於 Tcb 特殊許可權的呼叫端。
PSS_CREATE_USE_VM_ALLOCATIONS
值： 0x20000000
設施不應該針對任何持續性或暫時性配置使用進程堆積。 在某些情況下，可能不需要使用堆積，例如在例外狀況報告路徑中建立快照集， (堆積可能會損毀) 。
PSS_CREATE_MEASURE_PERFORMANCE
值： 0x40000000
測量設施的效能。 性能計數器可以透過 PssQuerySnapshot 擷取，並具有 PSS_QUERY_INFORMATION_CLASS 的 PSS_QUERY_PERFORMANCE_COUNTERS 信息類別。
PSS_CREATE_RELEASE_SECTION
值： 0x80000000
虛擬位址 (VA) 複製程式不會保存基礎映像的參考。 這會導致 VA 複製程式失敗，例如 QueryFullProcessImageName 等函式。

重要  

除非指定 PSS_CAPTURE_VA_CLONE ，否則此旗標沒有任何作用。


 

備註

如果同時指定 PSS_CREATE_FORCE_BREAKAWAY 和 PSS_CREATE_BREAKAWAY ， 則PSS_CREATE_FORCE_BREAKAWAY 優先。

規格需求

需求 值
最低支援的用戶端 Windows 8.1 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 R2 [僅限傳統型應用程式]
標頭 processsnapshot.h

另請參閱

處理快照集