Compartir a través de

enumeración PSS_CAPTURE_FLAGS (processsnapshot.h)

  • Artículo

Marcas que especifican qué captura 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;

Constantes

 
PSS_CAPTURE_NONE
Valor: 0x00000000
No captura nada.
PSS_CAPTURE_VA_CLONE
Valor: 0x00000001
Capture una instantánea de todas las páginas clonables del proceso. El clon incluye todas las regiones de MEM_PRIVATE , así como todas las secciones (MEM_MAPPED y MEM_IMAGE) que se pueden compartir. Todas las secciones de Win32 creadas a través de CreateFileMapping se pueden compartir.
PSS_CAPTURE_RESERVED_00000002
Valor: 0x00000002
(No use).
PSS_CAPTURE_HANDLES
Valor: 0x00000004
Capture la tabla de identificadores (solo los valores de identificador).
PSS_CAPTURE_HANDLE_NAME_INFORMATION
Valor: 0x00000008
Capturar información de nombre para cada identificador.
PSS_CAPTURE_HANDLE_BASIC_INFORMATION
Valor: 0x00000010
Capture información de identificador básica, como HandleCount, PointerCount, GrantedAccess, etc.
PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION
Valor: 0x00000020
Capturar información específica del tipo para los tipos de objeto admitidos: Process, Thread, Event, Mutant, Section.
PSS_CAPTURE_HANDLE_TRACE
Valor: 0x00000040
Capture la tabla de seguimiento de identificadores.
PSS_CAPTURE_THREADS
Valor: 0x00000080
Capturar información de subproceso (solo identificadores).
PSS_CAPTURE_THREAD_CONTEXT
Valor: 0x00000100
Capture el contexto de cada subproceso.
PSS_CAPTURE_THREAD_CONTEXT_EXTENDED
Valor: 0x00000200
Capturar contexto extendido para cada subproceso (por ejemplo , CONTEXT_XSTATE).
PSS_CAPTURE_RESERVED_00000400
Valor: 0x00000400
(No use).
PSS_CAPTURE_VA_SPACE
Valor: 0x00000800
Capture una instantánea del espacio de direcciones virtuales. El espacio va se captura como una matriz de estructuras de MEMORY_BASIC_INFORMATION . Esta marca no captura el contenido de las páginas.
PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION
Valor: 0x00001000
Para MEM_IMAGE y MEM_MAPPED regiones, volca la ruta de acceso al archivo que respalda las secciones (idénticas a las que devuelve GetMappedFileName ). En el caso de las regiones de MEM_IMAGE , también se volcado:



  • IMAGE_NT_HEADERS. FileHeader.TimeDateStamp



  • IMAGE_NT_HEADERS. OptionalHeader.SizeOfImage



  • IMAGE_NT_HEADERS. OptionalHeader.ImageBase



  • IMAGE_NT_HEADERS. OptionalHeader.CheckSum



El PROCESS_VM_READ derecho de acceso es necesario en el identificador del proceso.

Advertencia Esta opción solo es válida cuando se especifica PSS_CAPTURE_VA_SPACE .

 
PSS_CAPTURE_IPT_TRACE
Valor: 0x00002000
PSS_CREATE_BREAKAWAY_OPTIONAL
Valor: 0x04000000
El descanso es opcional. Si el proceso de clonación no se puede crear como un punto de interrupción, se crea todavía dentro del trabajo. Esta marca debe especificarse en combinación con PSS_CREATE_FORCE_BREAKAWAY o PSS_CREATE_BREAKAWAY.
PSS_CREATE_BREAKAWAY
Valor: 0x08000000
El clon se separa del trabajo del proceso primario. Esto equivale a la marcaCreateProcess CREATE_BREAKAWAY_FROM_JOB.
PSS_CREATE_FORCE_BREAKAWAY
Valor: 0x10000000
El clon se divide forzadamente del trabajo del proceso primario. Esto solo se permite para los autores de llamadas con privilegios de Tcb.
PSS_CREATE_USE_VM_ALLOCATIONS
Valor: 0x20000000
La instalación no debe usar el montón de procesos para las asignaciones persistentes o transitorias. El uso del montón puede no ser deseable en determinados contextos, como la creación de instantáneas en la ruta de acceso de informes de excepciones (donde el montón puede estar dañado).
PSS_CREATE_MEASURE_PERFORMANCE
Valor: 0x40000000
Mida el rendimiento de la instalación. Los contadores de rendimiento se pueden recuperar a través de PssQuerySnapshot con la clase de información PSS_QUERY_PERFORMANCE_COUNTERS de PSS_QUERY_INFORMATION_CLASS.
PSS_CREATE_RELEASE_SECTION
Valor: 0x80000000
El proceso de clonación de direcciones virtuales (VA) no contiene una referencia a la imagen subyacente. Esto hará que las funciones como QueryFullProcessImageName produzcan un error en el proceso de clonación de VA.

Importante  

Esta marca no tiene ningún efecto a menos que se especifique PSS_CAPTURE_VA_CLONE .


 

Comentarios

Si se especifican PSS_CREATE_FORCE_BREAKAWAY y PSS_CREATE_BREAKAWAY , PSS_CREATE_FORCE_BREAKAWAY tiene prioridad.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8.1 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 R2 [solo aplicaciones de escritorio]
Encabezado processsnapshot.h

Consulte también

Procesamiento de instantáneas