MINIDUMP_CALLBACK_TYPE enumeração (minidumpapiset.h)

Identifica o tipo de informações retornadas pela função MiniDumpCallback . Nem todas as falhas de memória causarão um retorno de chamada; por exemplo, se a falha estiver dentro de uma pilha, a falha será considerada irrecuperável e o minidump falhará.

Syntax

typedef enum _MINIDUMP_CALLBACK_TYPE {
  ModuleCallback,
  ThreadCallback,
  ThreadExCallback,
  IncludeThreadCallback,
  IncludeModuleCallback,
  MemoryCallback,
  CancelCallback,
  WriteKernelMinidumpCallback,
  KernelMinidumpStatusCallback,
  RemoveMemoryCallback,
  IncludeVmRegionCallback,
  IoStartCallback,
  IoWriteAllCallback,
  IoFinishCallback,
  ReadMemoryFailureCallback,
  SecondaryFlagsCallback,
  IsProcessSnapshotCallback,
  VmStartCallback,
  VmQueryCallback,
  VmPreReadCallback,
  VmPostReadCallback
} MINIDUMP_CALLBACK_TYPE;

Constantes

ModuleCallback A função de retorno de chamada retorna informações do módulo.
ThreadCallback A função de retorno de chamada retorna informações de thread.
ThreadExCallback A função de retorno de chamada retorna informações de thread estendidas.
IncludeThreadCallback A função de retorno de chamada indica quais threads devem ser incluídos. Ele é chamado como a biblioteca de minidespejo é enumerando os threads em um processo, em vez de depois que as informações são coletadas, como é com ThreadCallback ou ThreadExCallback. Ele é chamado para cada thread. Se a função de retorno de chamada retornar FALSE, o thread atual será excluído. Isso permite que o chamador obtenha informações para um subconjunto dos threads em um processo, sem suspender threads que não são de interesse. Como alternativa, você pode modificar o ThreadWriteFlags membro do MINIDUMP_CALLBACK_OUTPUT estrutura e retornar TRUE para evitar a coleta de informações desnecessárias para o Thread.
IncludeModuleCallback A função de retorno de chamada indica quais módulos devem ser incluídos. A função de retorno de chamada é chamada como A biblioteca minidump está enumerando os módulos em um processo, em vez de depois que as informações são coletadas, pois elas é com ModuleCallback. Ele é chamado para cada módulo. Se a função de retorno de chamada retorna FALSE, o módulo atual é excluído. Como alternativa, você pode modificar o Membro ModuleWriteFlags do estrutura MINIDUMP_CALLBACK_OUTPUT e retornar TRUE para evitar a coleta de informações desnecessárias para o módulo.
MemoryCallback A função de retorno de chamada retorna uma região de memória a ser incluída no despejo. O retorno de chamada é chamado apenas para despejos gerados sem o sinalizador MiniDumpWithFullMemory. Se a função de retorno de chamada retornar FALSE ou uma região de tamanho 0, o retorno de chamada não será chamado novamente. DbgHelp 6.1 e anterior: Não há suporte para esse valor.
CancelCallback A função de retorno de chamada retorna informações de cancelamento. DbgHelp 6.1 e anterior: Não há suporte para esse valor.
WriteKernelMinidumpCallback O minidespejo do modo de usuário foi concluído com êxito. Para iniciar um minidump no modo kernel, o retorno de chamada deve retornar TRUE e definir o membro Handle do MINIDUMP_CALLBACK_OUTPUT estrutura. DbgHelp 6.1 e anterior: Não há suporte para esse valor.
KernelMinidumpStatusCallback A função de retorno de chamada retorna status informações para o minidespejo do kernel. DbgHelp 6.1 e anterior: Não há suporte para esse valor.
RemoveMemoryCallback A função de retorno de chamada retorna uma região de memória a ser excluída do despejo. O retorno de chamada é chamado apenas para despejos gerados sem o sinalizador MiniDumpWithFullMemory . Se o retorno de chamada A função retorna FALSE ou uma região de tamanho 0, o retorno de chamada não será chamado novamente. DbgHelp 6.3 e anterior: Não há suporte para esse valor.
IncludeVmRegionCallback A função de retorno de chamada retorna informações sobre a região de memória virtual. Ele é chamado duas vezes para cada durante a passagem de gravação de memória completa. O membro VmRegion do estrutura MINIDUMP_CALLBACK_OUTPUT contém a região de memória atual. Você pode modificar o endereço base e o tamanho da região, desde que o novo region permanece um subconjunto da região original; as alterações em outros membros são ignoradas. Se o retorno de chamada retornar TRUE e define o membro Continue de MINIDUMP_CALLBACK_OUTPUT para TRUE, a biblioteca de minidespejo usará a região especificada por VmRegion como a região a ser gravada. Se o retorno de chamada retornar FALSE ou se Continue for FALSE, o retorno de chamada não será chamado para regiões de memória adicionais. DbgHelp 6.4 e anterior: Não há suporte para esse valor.
IoStartCallback A função de retorno de chamada indica que o chamador fornecerá uma rotina alternativa de E/S. Se o retorno de chamada retorna TRUE e define o membro Status de MINIDUMP_CALLBACK_OUTPUT para S_FALSE, a biblioteca de minidespejo enviará toda a E/S por meio de retornos de chamada. O chamador irá receber um retorno de chamada IoWriteAllCallback para cada parte dos dados. DbgHelp 6.4 e anterior: Não há suporte para esse valor.
IoWriteAllCallback O retorno de chamada deve gravar todos os bytes solicitados ou falhar. O membro de E/ S do MINIDUMP_CALLBACK_INPUT estrutura contém a solicitação. Se a operação de gravação falhar, o retorno de chamada deverá retornar FALSE. Se a opção operação de gravação bem-sucedida, o retorno de chamada deve retornar TRUE e definir o Membro de status de MINIDUMP_CALLBACK_OUTPUT para S_OK. O chamador receberá um retorno de chamada IoFinishCallback quando a E/S for concluída. DbgHelp 6.4 e anterior: Não há suporte para esse valor.
IoFinishCallback O retorno de chamada retorna informações de conclusão de E/S. Se o retorno de chamada retornar FALSE ou não define o membro Status de MINIDUMP_CALLBACK_OUTPUT para S_OK, a biblioteca de minidespejo pressupõe que a operação de gravação do minidespejo falhou. DbgHelp 6.4 e anterior: Não há suporte para esse valor.
ReadMemoryFailureCallback Houve uma falha ao ler memória. Se o retorno de chamada retornar TRUE e definir o membro Status de MINIDUMP_CALLBACK_OUTPUT para S_OK, a falha de memória é ignorada e o bloco é omitido do minidump. Caso contrário, isso falha resulta em uma falha ao gravar no minidump. DbgHelp 6.4 e anteriores: Não há suporte para esse valor.
SecondaryFlagsCallback O retorno de chamada retorna informações secundárias. DbgHelp 6.5 e anterior: Não há suporte para esse valor.
IsProcessSnapshotCallback A função de retorno de chamada indica se o destino é um processo ou um instantâneo. DbgHelp 6.2 e anteriores: Não há suporte para esse valor.
VmStartCallback A função de retorno de chamada indica se o receptor dá suporte e aceita retornos de chamada de memória virtual, como VmQueryCallback, VmPreReadCallback e VmPostReadCallback. Um valor retornado de S_FALSE significa que há suporte para retornos de chamada de memória virtual. Um valor de S_OK significa que não há suporte para retornos de chamada de memória virtual. DbgHelp 6.2 e anteriores: Não há suporte para esse valor.
VmQueryCallback A função de retorno de chamada é invocada para instantâneo destinos para coletar informações de memória de endereço virtual do destino. O retorno de chamada só será chamado se VmStartCallback retornar um valor de S_FALSE. DbgHelp 6.2 e anteriores: Não há suporte para esse valor.
VmPreReadCallback A função de retorno de chamada é enviada para cada operação ReadVirtual. Essas leituras não se limitam aos blocos de memória adicionados ao despejo. O mecanismo também acessa o PEB (Process Environment Block), o TEB (Thread Environment Block), os dados do carregador, os rastreamentos de módulo descarregados e outros blocos. Mesmo que esses blocos não acabem no despejo, eles são lidos do destino e os retornos de chamada de memória virtual são iniciados para cada um. O retorno de chamada só será chamado se VmStartCallback retornar S_FALSE. DbgHelp 6.2 e anteriores: Não há suporte para esse valor.
VmPostReadCallback A função de retorno de chamada permite que o receptor altere o conteúdo do buffer com dados de outras fontes, como um cache, ou execute ofuscação. O buffer neste ponto é totalmente ou parcialmente preenchido por VmPreReadCallback e por ReadProcessMemory. O retorno de chamada só será chamado se VmStartCallback retornar S_FALSE. DbgHelp 6.2 e anteriores: Não há suporte para esse valor.

Requisitos

Requisito	Valor
Cabeçalho	minidumpapiset.h (inclua DbgHelp.h)
Redistribuível	DbgHelp.dll 5.1 ou posterior

Confira também

MINIDUMP_CALLBACK_INPUT

MiniDumpCallback