Condividi tramite

enumerazione MINIDUMP_CALLBACK_TYPE (minidumpapiset.h)

  • Articolo

Identifica il tipo di informazioni restituite dalla funzione MiniDumpCallback . Non tutti gli errori di memoria causeranno un callback; ad esempio se l'errore si trova all'interno di uno stack, l'errore viene considerato irreversibile e il minidump avrà esito negativo.

Sintassi

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;

Costanti

 
ModuleCallback
La funzione di callback restituisce informazioni sul modulo.
ThreadCallback
La funzione di callback restituisce informazioni sul thread.
ThreadExCallback
La funzione di callback restituisce informazioni sul thread esteso.
IncludeThreadCallback
La funzione di callback indica quali thread devono essere inclusi. Viene chiamato come la libreria minidump è
enumerazione dei thread in un processo, anziché dopo la raccolta delle informazioni, come avvieni con
ThreadCallback o ThreadExCallback. Si chiama per
ogni thread. Se la funzione di callback restituisce FALSE, il thread corrente viene escluso.
In questo modo il chiamante può ottenere informazioni per un subset dei thread in un processo, senza sospendere
thread che non sono di interesse. In alternativa, è possibile modificare ThreadWriteFlags
membro del MINIDUMP_CALLBACK_OUTPUT
struttura e restituire TRUE per evitare di raccogliere informazioni non necessarie per il
Thread.
IncludeModuleCallback
La funzione di callback indica quali moduli devono essere inclusi. La funzione di callback viene chiamata come
la libreria minidump enumera i moduli in un processo, anziché dopo la raccolta delle informazioni, in quanto vengono raccolte
è con ModuleCallback. Viene chiamato per ogni modulo. Se la funzione di callback
restituisce FALSE, il modulo corrente viene escluso. In alternativa, è possibile modificare il
Membro ModuleWriteFlags del
struttura MINIDUMP_CALLBACK_OUTPUT e
restituisce TRUE per evitare di raccogliere informazioni non necessarie per il modulo.
MemoryCallback
La funzione di callback restituisce un'area di memoria da includere nel dump. Il callback viene chiamato solo
per i dump generati senza il flag MiniDumpWithFullMemory. Se la funzione di callback restituisce
FALSE o un'area di dimensioni 0, il callback non verrà chiamato di nuovo.


DbgHelp 6.1 e versioni precedenti: Questo valore non è supportato.
CancelCallback
La funzione di callback restituisce informazioni sull'annullamento.


DbgHelp 6.1 e versioni precedenti: Questo valore non è supportato.
WriteKernelMinidumpCallback
Il minidump in modalità utente è stato completato correttamente. Per avviare un minidump in modalità kernel, il callback
deve restituire TRUE e impostare il membro Handle dell'oggetto
MINIDUMP_CALLBACK_OUTPUT struttura.


DbgHelp 6.1 e versioni precedenti: Questo valore non è supportato.
KernelMinidumpStatusCallback
La funzione di callback restituisce informazioni sullo stato per il minidump del kernel.


DbgHelp 6.1 e versioni precedenti: Questo valore non è supportato.
RemoveMemoryCallback
La funzione di callback restituisce un'area di memoria da escludere dal dump. Il callback viene chiamato solo
per i dump generati senza il flag MiniDumpWithFullMemory . Se il callback
la funzione restituisce FALSE o un'area di dimensioni 0, il callback non verrà chiamato di nuovo.


DbgHelp 6.3 e versioni precedenti: Questo valore non è supportato.
IncludeVmRegionCallback
La funzione di callback restituisce informazioni sull'area di memoria virtuale. Viene chiamato due volte per ogni
durante il passaggio di scrittura full-memory. Membro VmRegion dell'oggetto
struttura MINIDUMP_CALLBACK_OUTPUT
contiene l'area di memoria corrente. È possibile modificare l'indirizzo di base e le dimensioni dell'area, purché il nuovo
l'area rimane un sottoinsieme dell'area originale; le modifiche apportate ad altri membri vengono ignorate. Se il callback restituisce
TRUE e imposta il membro Continue di
MINIDUMP_CALLBACK_OUTPUT a
TRUE, la libreria minidump userà l'area specificata da
VmRegion come area da scrivere. Se il callback restituisce
FALSE o se Continue è FALSE,
il callback non verrà chiamato per aree di memoria aggiuntive.


DbgHelp 6.4 e versioni precedenti: Questo valore non è supportato.
IoStartCallback
La funzione di callback indica che il chiamante fornirà una routine di I/O alternativa. Se il callback
restituisce TRUE e imposta il membro Status di
MINIDUMP_CALLBACK_OUTPUT a
S_FALSE, la libreria minidump invierà tutte le operazioni di I/O tramite callback. Il chiamante
ricevere un callback IoWriteAllCallback per ogni parte di dati.


DbgHelp 6.4 e versioni precedenti: Questo valore non è supportato.
IoWriteAllCallback
Il callback deve scrivere tutti i byte richiesti o ha esito negativo. Membro Io del
struttura MINIDUMP_CALLBACK_INPUT contiene
la richiesta. Se l'operazione di scrittura non riesce, il callback deve restituire FALSE. Se il parametro
l'operazione di scrittura ha esito positivo, il callback deve restituire TRUE e impostare
Membro di stato di
MINIDUMP_CALLBACK_OUTPUT a
S_OK. Il chiamante riceverà un callback IoFinishCallback
al termine dell'I/O.


DbgHelp 6.4 e versioni precedenti: Questo valore non è supportato.
IoFinishCallback
Il callback restituisce informazioni di completamento di I/O. Se il callback restituisce FALSE o
non imposta il membro Status di
MINIDUMP_CALLBACK_OUTPUT a
S_OK, la libreria minidump presuppone che l'operazione di scrittura minidump non sia riuscita.


DbgHelp 6.4 e versioni precedenti: Questo valore non è supportato.
ReadMemoryFailureCallback
Si è verificato un errore durante la lettura della memoria. Se il callback restituisce TRUE e imposta
membro Status di
MINIDUMP_CALLBACK_OUTPUT a
S_OK, l'errore di memoria viene ignorato e il blocco viene omesso dal minidump. In caso contrario,
l'errore genera un errore durante la scrittura nel minidump.


DbgHelp 6.4 e versioni precedenti: Questo valore non è supportato.
SecondaryFlagsCallback
Il callback restituisce informazioni secondarie.


DbgHelp 6.5 e versioni precedenti: Questo valore non è supportato.
IsProcessSnapshotCallback
La funzione di callback indica se la destinazione è un processo o uno snapshot.

DbgHelp 6.2 e versioni precedenti: Questo valore non è supportato.
VmStartCallback
La funzione di callback indica se il chiamato supporta e accetta callback di memoria virtuale, ad esempio VmQueryCallback, VmPreReadCallback e VmPostReadCallback.

Un valore restituito di S_FALSE indica che sono supportati i callback di memoria virtuale. Un valore di S_OK indica che i callback di memoria virtuale non sono supportati.

DbgHelp 6.2 e versioni precedenti: Questo valore non è supportato.
VmQueryCallback
La funzione di callback viene richiamata per le destinazioni snapshot per raccogliere informazioni sulla memoria degli indirizzi virtuali dalla destinazione.
Il callback viene chiamato solo se VmStartCallback ha restituito un valore di S_FALSE.


DbgHelp 6.2 e versioni precedenti: Questo valore non è supportato.
VmPreReadCallback
La funzione di callback viene inviata per ogni operazione ReadVirtual. Queste letture non sono limitate ai blocchi di memoria aggiunti al dump. Il motore accede anche al blocco di ambiente di elaborazione (PEB), al blocco di ambiente thread (TEB), ai dati del caricatore, alle tracce dei moduli scaricati e ad altri blocchi. Anche se questi blocchi non finiscono nel dump, vengono letti dalla destinazione e i callback di memoria virtuale vengono avviati per ognuno. Il callback viene chiamato solo se VmStartCallback ha restituito S_FALSE.

DbgHelp 6.2 e versioni precedenti: Questo valore non è supportato.
VmPostReadCallback
La funzione di callback consente al chiamato di modificare il contenuto del buffer con i dati di altre origini, ad esempio una cache, o di eseguire l'offuscamento. Il buffer a questo punto è completamente o parzialmente riempito da VmPreReadCallback e da ReadProcessMemory. Il callback viene chiamato solo se VmStartCallback ha restituito S_FALSE.

DbgHelp 6.2 e versioni precedenti: Questo valore non è supportato.

Requisiti

Requisito Valore
Intestazione minidumpapiset.h (include DbgHelp.h)
Componente ridistribuibile DbgHelp.dll 5.1 o versione successiva

Vedi anche

MINIDUMP_CALLBACK_INPUT

MiniDumpCallback