Freigeben über

PSS_CAPTURE_FLAGS-Enumeration (processsnapshot.h)

  • Artikel

Flags, die angeben, was PssCaptureSnapshot erfasst.

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;

Konstanten

 
PSS_CAPTURE_NONE
Wert: 0x00000000
Erfassen Sie nichts.
PSS_CAPTURE_VA_CLONE
Wert: 0x00000001
Erfassen Sie eine Momentaufnahme aller geklonten Seiten im Prozess. Der Klon enthält alle MEM_PRIVATE Regionen sowie alle Abschnitte (MEM_MAPPED und MEM_IMAGE), die gemeinsam verwendet werden können. Alle win32-Abschnitte, die über CreateFileMapping erstellt werden, können freigegeben werden.
PSS_CAPTURE_RESERVED_00000002
Wert: 0x00000002
(Verwenden Sie nicht.)
PSS_CAPTURE_HANDLES
Wert: 0x00000004
Erfassen Sie die Handletabelle (nur Handle-Werte).
PSS_CAPTURE_HANDLE_NAME_INFORMATION
Wert: 0x00000008
Erfassen Sie Namensinformationen für jedes Handle.
PSS_CAPTURE_HANDLE_BASIC_INFORMATION
Wert: 0x00000010
Erfassen Sie grundlegende Handle-Informationen wie HandleCount, PointerCount, GrantedAccess usw.
PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION
Wert: 0x00000020
Erfassen Sie typspezifische Informationen für unterstützte Objekttypen: Process, Thread, Event, Mutant, Section.
PSS_CAPTURE_HANDLE_TRACE
Wert: 0x00000040
Erfassen Sie die Handle-Ablaufverfolgungstabelle.
PSS_CAPTURE_THREADS
Wert: 0x00000080
Erfassen von Threadinformationen (nur IDs).
PSS_CAPTURE_THREAD_CONTEXT
Wert: 0x00000100
Erfassen Sie den Kontext für jeden Thread.
PSS_CAPTURE_THREAD_CONTEXT_EXTENDED
Wert: 0x00000200
Erfassen Sie den erweiterten Kontext für jeden Thread (z. B. CONTEXT_XSTATE).
PSS_CAPTURE_RESERVED_00000400
Wert: 0x00000400
(Verwenden Sie nicht.)
PSS_CAPTURE_VA_SPACE
Wert: 0x00000800
Erfassen Sie eine Momentaufnahme des virtuellen Adressraums. Der Va-Bereich wird als Array von MEMORY_BASIC_INFORMATION-Strukturen erfasst. Dieses Flag erfasst nicht den Inhalt der Seiten.
PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION
Wert: 0x00001000
Für MEM_IMAGE - und MEM_MAPPED-Regionen wird der Pfad zu der Datei, die die Abschnitte unterstützt, gespeichert (identisch mit dem, was GetMappedFileName zurückgibt). Für MEM_IMAGE Regionen auch Dumps:



  • IMAGE_NT_HEADERS. FileHeader.TimeDateStamp



  • IMAGE_NT_HEADERS. OptionalHeader.SizeOfImage



  • IMAGE_NT_HEADERS. OptionalHeader.ImageBase



  • IMAGE_NT_HEADERS. OptionalHeader.CheckSum



Das PROCESS_VM_READ Zugriffsrecht ist für das Prozesshandle erforderlich.

Warnung Diese Option ist nur gültig, wenn PSS_CAPTURE_VA_SPACE angegeben ist.

 
PSS_CAPTURE_IPT_TRACE
Wert: 0x00002000
PSS_CREATE_BREAKAWAY_OPTIONAL
Wert: 0x04000000
Der Abbruch ist optional. Wenn der Klonprozess nicht als Unterbrechung erstellt werden kann, wird er noch innerhalb des Auftrags erstellt. Dieses Flag muss in Kombination mit PSS_CREATE_FORCE_BREAKAWAY und/oder PSS_CREATE_BREAKAWAY angegeben werden.
PSS_CREATE_BREAKAWAY
Wert: 0x08000000
Der Klon wird vom Auftrag des übergeordneten Prozesses getrennt. Dies entspricht dem CreateProcess-FlagCREATE_BREAKAWAY_FROM_JOB.
PSS_CREATE_FORCE_BREAKAWAY
Wert: 0x10000000
Der Klon wird zwangsweise vom Auftrag des übergeordneten Prozesses getrennt. Dies ist nur für Tcb-privilegierte Aufrufer zulässig.
PSS_CREATE_USE_VM_ALLOCATIONS
Wert: 0x20000000
Die Einrichtung sollte den Prozessheap nicht für persistente oder vorübergehende Zuordnungen verwenden. Die Verwendung des Heaps kann in bestimmten Kontexten unerwünscht sein, z. B. in der Erstellung von Momentaufnahmen im Ausnahmeberichtspfad (wo der Heap möglicherweise beschädigt ist).
PSS_CREATE_MEASURE_PERFORMANCE
Wert: 0x40000000
Messen der Leistung der Einrichtung. Leistungsindikatoren können über PssQuerySnapshot mit der PSS_QUERY_PERFORMANCE_COUNTERS Informationsklasse von PSS_QUERY_INFORMATION_CLASS abgerufen werden.
PSS_CREATE_RELEASE_SECTION
Wert: 0x80000000
Der Klonprozess für virtuelle Adressen (VA) enthält keinen Verweis auf das zugrunde liegende Image. Dies führt dazu, dass Funktionen wie QueryFullProcessImageName im VA-Klonprozess fehlschlagen.

Wichtig  

Dieses Flag hat keine Auswirkung, es sei denn , PSS_CAPTURE_VA_CLONE angegeben ist.


 

Hinweise

Wenn sowohl PSS_CREATE_FORCE_BREAKAWAY als auch PSS_CREATE_BREAKAWAY angegeben sind, hat PSS_CREATE_FORCE_BREAKAWAY Vorrang.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 R2 [nur Desktop-Apps]
Kopfzeile processsnapshot.h

Weitere Informationen

Prozessmomentaufnahme