Compartilhar via

PSS_CAPTURE_FLAGS enumeração (processsnapshot.h)

  • Artigo

Sinalizadores que especificam o que PssCaptureSnapshot captura.

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
Não capture nada.
PSS_CAPTURE_VA_CLONE
Valor: 0x00000001
Capture um instantâneo de todas as páginas clonáveis no processo. O clone inclui todas as regiões MEM_PRIVATE , bem como todas as seções (MEM_MAPPED e MEM_IMAGE) compartilháveis. Todas as seções do Win32 criadas por meio de CreateFileMapping são compartilháveis.
PSS_CAPTURE_RESERVED_00000002
Valor: 0x00000002
(Não use.)
PSS_CAPTURE_HANDLES
Valor: 0x00000004
Capture a tabela de identificadores (somente valores de identificador).
PSS_CAPTURE_HANDLE_NAME_INFORMATION
Valor: 0x00000008
Capturar informações de nome para cada identificador.
PSS_CAPTURE_HANDLE_BASIC_INFORMATION
Valor: 0x00000010
Capture informações básicas do identificador, como HandleCount, PointerCount, GrantedAccess etc.
PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION
Valor: 0x00000020
Capturar informações específicas do tipo para tipos de objeto com suporte: Process, Thread, Event, Mutant, Section.
PSS_CAPTURE_HANDLE_TRACE
Valor: 0x00000040
Capture a tabela de rastreamento de identificador.
PSS_CAPTURE_THREADS
Valor: 0x00000080
Capturar informações de thread (somente IDs).
PSS_CAPTURE_THREAD_CONTEXT
Valor: 0x00000100
Capture o contexto para cada thread.
PSS_CAPTURE_THREAD_CONTEXT_EXTENDED
Valor: 0x00000200
Capturar contexto estendido para cada thread (por exemplo , CONTEXT_XSTATE).
PSS_CAPTURE_RESERVED_00000400
Valor: 0x00000400
(Não use.)
PSS_CAPTURE_VA_SPACE
Valor: 0x00000800
Capture um instantâneo do espaço de endereço virtual. O espaço va é capturado como uma matriz de estruturas de MEMORY_BASIC_INFORMATION . Esse sinalizador não captura o conteúdo das páginas.
PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION
Valor: 0x00001000
Para regiões MEM_IMAGE e MEM_MAPPED , despeja o caminho para o arquivo que dá suporte às seções (idênticas ao que GetMappedFileName retorna). Para regiões MEM_IMAGE , também despejos:



  • IMAGE_NT_HEADERS. FileHeader.TimeDateStamp



  • IMAGE_NT_HEADERS. OptionalHeader.SizeOfImage



  • IMAGE_NT_HEADERS. OptionalHeader.ImageBase



  • IMAGE_NT_HEADERS. OptionalHeader.CheckSum



O direito de acesso PROCESS_VM_READ é necessário no identificador do processo.

Aviso Essa opção só é válida quando PSS_CAPTURE_VA_SPACE é especificado.

 
PSS_CAPTURE_IPT_TRACE
Valor: 0x00002000
PSS_CREATE_BREAKAWAY_OPTIONAL
Valor: 0x04000000
A fuga é opcional. Se o processo de clonagem não for criado como uma separação, ele será criado ainda dentro do trabalho. Esse sinalizador deve ser especificado em combinação com PSS_CREATE_FORCE_BREAKAWAY e/ou PSS_CREATE_BREAKAWAY.
PSS_CREATE_BREAKAWAY
Valor: 0x08000000
O clone é separado do trabalho do processo pai. Isso é equivalente ao sinalizador CreateProcessCREATE_BREAKAWAY_FROM_JOB.
PSS_CREATE_FORCE_BREAKAWAY
Valor: 0x10000000
O clone é dividido com força no trabalho do processo pai. Isso só é permitido para chamadores com privilégios Tcb.
PSS_CREATE_USE_VM_ALLOCATIONS
Valor: 0x20000000
A instalação não deve usar o heap de processo para alocações persistentes ou transitórias. O uso do heap pode ser indesejável em determinados contextos, como a criação de instantâneos no caminho de relatório de exceção (em que o heap pode estar corrompido).
PSS_CREATE_MEASURE_PERFORMANCE
Valor: 0x40000000
Medir o desempenho da instalação. Os contadores de desempenho podem ser recuperados por meio de PssQuerySnapshot com a classe de informações PSS_QUERY_PERFORMANCE_COUNTERS de PSS_QUERY_INFORMATION_CLASS.
PSS_CREATE_RELEASE_SECTION
Valor: 0x80000000
O processo de clone de VA (endereço virtual) não contém uma referência à imagem subjacente. Isso fará com que funções como QueryFullProcessImageName falhem no processo de clonagem de VA.

Importante  

Esse sinalizador não tem efeito, a menos que PSS_CAPTURE_VA_CLONE seja especificado.


 

Comentários

Se PSS_CREATE_FORCE_BREAKAWAY e PSS_CREATE_BREAKAWAY forem especificados, PSS_CREATE_FORCE_BREAKAWAY terá precedência.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8.1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 R2 [somente aplicativos da área de trabalho]
Cabeçalho processsnapshot.h

Confira também

Processamento de instantâneos