Partager via

énumération PSS_CAPTURE_FLAGS (processsnapshot.h)

  • Article

Indicateurs qui spécifient ce que PssCaptureSnapshot capture.

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;

Constantes

 
PSS_CAPTURE_NONE
Valeur : 0x00000000
Ne capturez rien.
PSS_CAPTURE_VA_CLONE
Valeur : 0x00000001
Capturez une instantané de toutes les pages cloneables dans le processus. Le clone inclut toutes les régions MEM_PRIVATE , ainsi que toutes les sections (MEM_MAPPED et MEM_IMAGE) qui sont partageables. Toutes les sections Win32 créées via CreateFileMapping sont partageables.
PSS_CAPTURE_RESERVED_00000002
Valeur : 0x00000002
(Ne pas utiliser.)
PSS_CAPTURE_HANDLES
Valeur : 0x00000004
Capturez la table de handles (valeurs de handle uniquement).
PSS_CAPTURE_HANDLE_NAME_INFORMATION
Valeur : 0x00000008
Capturez les informations de nom pour chaque handle.
PSS_CAPTURE_HANDLE_BASIC_INFORMATION
Valeur : 0x00000010
Capturez des informations de handle de base telles que HandleCount, PointerCount, GrantedAccess, etc.
PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION
Valeur : 0x00000020
Capturez des informations spécifiques au type pour les types d’objets pris en charge : Process, Thread, Event, Mutant, Section.
PSS_CAPTURE_HANDLE_TRACE
Valeur : 0x00000040
Capturez la table de suivi de handle.
PSS_CAPTURE_THREADS
Valeur : 0x00000080
Capturer des informations sur les threads (ID uniquement).
PSS_CAPTURE_THREAD_CONTEXT
Valeur : 0x00000100
Capturez le contexte de chaque thread.
PSS_CAPTURE_THREAD_CONTEXT_EXTENDED
Valeur : 0x00000200
Capturez le contexte étendu pour chaque thread (par exemple , CONTEXT_XSTATE).
PSS_CAPTURE_RESERVED_00000400
Valeur : 0x00000400
(Ne pas utiliser.)
PSS_CAPTURE_VA_SPACE
Valeur : 0x00000800
Capturez une instantané de l’espace d’adressage virtuel. L’espace VA est capturé sous la forme d’un tableau de structures MEMORY_BASIC_INFORMATION . Cet indicateur ne capture pas le contenu des pages.
PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION
Valeur : 0x00001000
Pour MEM_IMAGE et MEM_MAPPED régions, vide le chemin d’accès au fichier qui contient les sections (identique à ce que renvoie GetMappedFileName ). Pour MEM_IMAGE régions, effectue également des vidages :



  • IMAGE_NT_HEADERS. FileHeader.TimeDateStamp



  • IMAGE_NT_HEADERS. OptionalHeader.SizeOfImage



  • IMAGE_NT_HEADERS. OptionalHeader.ImageBase



  • IMAGE_NT_HEADERS. OptionalHeader.CheckSum



Le droit d’accès PROCESS_VM_READ est requis sur le handle de processus.

Avertissement Cette option n’est valide que lorsque PSS_CAPTURE_VA_SPACE est spécifié.

 
PSS_CAPTURE_IPT_TRACE
Valeur : 0x00002000
PSS_CREATE_BREAKAWAY_OPTIONAL
Valeur : 0x04000000
L’échappée est facultative. Si le processus de clonage ne parvient pas à créer en tant qu’interruption, il est créé toujours à l’intérieur du travail. Cet indicateur doit être spécifié en combinaison avec PSS_CREATE_FORCE_BREAKAWAY et/ou PSS_CREATE_BREAKAWAY.
PSS_CREATE_BREAKAWAY
Valeur : 0x08000000
Le clone est supprimé du travail du processus parent. Cela équivaut à l’indicateur CreateProcessCREATE_BREAKAWAY_FROM_JOB.
PSS_CREATE_FORCE_BREAKAWAY
Valeur : 0x10000000
Le clone est rompu de force le travail du processus parent. Cela n’est autorisé que pour les appelants privilégiés par Tcb.
PSS_CREATE_USE_VM_ALLOCATIONS
Valeur : 0x20000000
L’installation ne doit pas utiliser le tas de processus pour les allocations persistantes ou temporaires. L’utilisation du tas peut être indésirable dans certains contextes, tels que la création d’instantanés dans le chemin de création de rapports d’exception (où le tas peut être endommagé).
PSS_CREATE_MEASURE_PERFORMANCE
Valeur : 0x40000000
Mesurer les performances de l’installation. Les compteurs de performances peuvent être récupérés via PssQuerySnapshot avec la classe d’informations PSS_QUERY_PERFORMANCE_COUNTERS de PSS_QUERY_INFORMATION_CLASS.
PSS_CREATE_RELEASE_SECTION
Valeur : 0x80000000
Le processus de clonage d’adresse virtuelle (VA) ne contient pas de référence à l’image sous-jacente. Cela entraîne l’échec de fonctions telles que QueryFullProcessImageName sur le processus de clonage de l’instance d’évaluation.

Important  

Cet indicateur n’a aucun effet, sauf si PSS_CAPTURE_VA_CLONE est spécifié.


 

Remarques

Si PSS_CREATE_FORCE_BREAKAWAY et PSS_CREATE_BREAKAWAY sont spécifiés, PSS_CREATE_FORCE_BREAKAWAY est prioritaire.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8.1 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 R2 [applications de bureau uniquement]
En-tête processsnapshot.h

Voir aussi

Traiter la capture instantanée