Partager via

énumération MINIDUMP_CALLBACK_TYPE (minidumpapiset.h)

  • Article

Identifie le type d’informations retournées par la fonction MiniDumpCallback . Les défaillances de mémoire ne provoquent pas toutes un rappel ; par exemple, si l’échec se trouve dans une pile, l’échec est considéré comme irrécupérable et le minidump échoue.

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
La fonction de rappel retourne des informations de module.
ThreadCallback
La fonction de rappel retourne des informations de thread.
ThreadExCallback
La fonction de rappel retourne des informations de thread étendues.
IncludeThreadCallback
La fonction de rappel indique les threads à inclure. Il est appelé comme la bibliothèque minidump est
énumération des threads dans un processus, plutôt qu’après les informations collectées, comme c’est le cas avec
ThreadCallback ou ThreadExCallback. Il est demandé pour
chaque thread. Si la fonction de rappel retourne FALSE, le thread actuel est exclu.
Cela permet à l’appelant d’obtenir des informations sur un sous-ensemble des threads d’un processus, sans interrompre
threads qui ne sont pas d’intérêt. Vous pouvez également modifier threadWriteFlags
membre du MINIDUMP_CALLBACK_OUTPUT
structure et retourne TRUE pour éviter la collecte d’informations inutiles pour le
Fil.
IncludeModuleCallback
La fonction de rappel indique les modules à inclure. La fonction de rappel est appelée en tant que
minidump library énumére les modules dans un processus, plutôt qu’après la collecte des informations, car elle
est avec ModuleCallback. Il est appelé pour chaque module. Si la fonction de rappel
retourne FALSE, le module actuel est exclu. Vous pouvez également modifier le
ModuleWriteFlags membre du
MINIDUMP_CALLBACK_OUTPUT structure et
retourne TRUE pour éviter la collecte d’informations inutiles pour le module.
MemoryCallback
La fonction de rappel retourne une région de mémoire à inclure dans le vidage. Le rappel est appelé uniquement
pour les vidages générés sans l’indicateur MiniDumpWithFullMemory. Si la fonction de rappel retourne
FALSE ou une région de taille 0, le rappel ne sera plus appelé.


DbgHelp 6.1 et versions antérieures : Cette valeur n’est pas prise en charge.
CancelCallback
La fonction de rappel retourne des informations d’annulation.


DbgHelp 6.1 et versions antérieures : Cette valeur n’est pas prise en charge.
WriteKernelMinidumpCallback
Le minidump en mode utilisateur a été correctement terminé. Pour lancer un minidump en mode noyau, le rappel
doit retourner TRUE et définir le membre Handle du
MINIDUMP_CALLBACK_OUTPUT structure.


DbgHelp 6.1 et versions antérieures : Cette valeur n’est pas prise en charge.
KernelMinidumpStatusCallback
La fonction de rappel retourne status informations pour le minidump du noyau.


DbgHelp 6.1 et versions antérieures : Cette valeur n’est pas prise en charge.
RemoveMemoryCallback
La fonction de rappel retourne une région de mémoire à exclure du vidage. Le rappel est appelé uniquement
pour les vidages générés sans l’indicateur MiniDumpWithFullMemory . Si le rappel
la fonction retourne FALSE ou une région de taille 0, le rappel n’est plus appelé.


DbgHelp 6.3 et versions antérieures : Cette valeur n’est pas prise en charge.
IncludeVmRegionCallback
La fonction de rappel retourne des informations sur la région de mémoire virtuelle. Il est appelé deux fois pour chaque
pendant la passe d’écriture de mémoire complète. Membre VmRegion du
structure MINIDUMP_CALLBACK_OUTPUT
contient la région de mémoire actuelle. Vous pouvez modifier l’adresse de base et la taille de la région, tant que la nouvelle
region reste un sous-ensemble de la région d’origine ; les modifications apportées aux autres membres sont ignorées. Si le rappel retourne
TRUE et définit le membre Continuer de
MINIDUMP_CALLBACK_OUTPUT à
TRUE, la bibliothèque minidump utilise la région spécifiée par
VmRegion comme région à écrire. Si le rappel retourne
FALSE ou si Continuer a la valeur FALSE,
le rappel ne sera pas appelé pour les régions de mémoire supplémentaires.


DbgHelp 6.4 et versions antérieures : Cette valeur n’est pas prise en charge.
IoStartCallback
La fonction de rappel indique que l’appelant fournira une autre routine d’E/S. Si le rappel
retourne TRUE et définit le membre Status de
MINIDUMP_CALLBACK_OUTPUT à
S_FALSE, la bibliothèque minidump envoie toutes les E/S via des rappels. L’appelant va
recevoir un rappel IoWriteAllCallback pour chaque élément de données.


DbgHelp 6.4 et versions antérieures : Cette valeur n’est pas prise en charge.
IoWriteAllCallback
Le rappel doit écrire tous les octets demandés ou échouer. Membre Io du
MINIDUMP_CALLBACK_INPUT structure contient
la demande. Si l’opération d’écriture échoue, le rappel doit retourner FALSE. Si la
l’opération d’écriture réussit, le rappel doit retourner TRUE et définir le
Membre d’état de
MINIDUMP_CALLBACK_OUTPUT à
S_OK. L’appelant recevra un rappel IoFinishCallback
lorsque les E/S sont terminées.


DbgHelp 6.4 et versions antérieures : Cette valeur n’est pas prise en charge.
IoFinishCallback
Le rappel retourne les informations d’achèvement des E/S. Si le rappel retourne FALSE ou
ne définit pas le membre Status de
MINIDUMP_CALLBACK_OUTPUT à
S_OK, la bibliothèque minidump suppose que l’opération d’écriture minidump a échoué.


DbgHelp 6.4 et versions antérieures : Cette valeur n’est pas prise en charge.
ReadMemoryFailureCallback
Échec de la lecture de la mémoire. Si le rappel retourne TRUE et définit
le membre Status de
MINIDUMP_CALLBACK_OUTPUT à
S_OK, la mémoire défaillante est ignorée et le bloc est omis du minidump. Sinon, ceci
l’échec entraîne l’échec de l’écriture dans le minidump.


DbgHelp 6.4 et versions antérieures : Cette valeur n’est pas prise en charge.
SecondaryFlagsCallback
Le rappel retourne des informations secondaires.


DbgHelp 6.5 et versions antérieures : Cette valeur n’est pas prise en charge.
IsProcessSnapshotCallback
La fonction de rappel indique si la cible est un processus ou un instantané.

DbgHelp 6.2 et versions antérieures : Cette valeur n’est pas prise en charge.
VmStartCallback
La fonction de rappel indique si l’appelé prend en charge et accepte les rappels de mémoire virtuelle, tels que VmQueryCallback, VmPreReadCallback et VmPostReadCallback.

Une valeur de retour de S_FALSE signifie que les rappels de mémoire virtuelle sont pris en charge. La valeur S_OK signifie que les rappels de mémoire virtuelle ne sont pas pris en charge.

DbgHelp 6.2 et versions antérieures : Cette valeur n’est pas prise en charge.
VmQueryCallback
La fonction de rappel est appelée pour instantané cibles afin de collecter des informations de mémoire d’adresse virtuelle à partir de la cible.
Le rappel est appelé uniquement si VmStartCallback a retourné une valeur de S_FALSE.


DbgHelp 6.2 et versions antérieures : Cette valeur n’est pas prise en charge.
VmPreReadCallback
La fonction de rappel est envoyée pour chaque opération ReadVirtual. Ces lectures ne sont pas limitées aux blocs de mémoire ajoutés au vidage. Le moteur accède également au bloc d’environnement de processus (PEB), au bloc d’environnement de thread (TEB), aux données du chargeur, aux traces de module déchargées et à d’autres blocs. Même si ces blocs ne se retrouvent pas dans le vidage, ils sont lus à partir de la cible et des rappels de mémoire virtuelle sont lancés pour chacun d’eux. Le rappel est appelé uniquement si VmStartCallback a retourné S_FALSE.

DbgHelp 6.2 et versions antérieures : Cette valeur n’est pas prise en charge.
VmPostReadCallback
La fonction de rappel permet à l’appelé de modifier le contenu de la mémoire tampon avec des données provenant d’autres sources, telles qu’un cache, ou d’effectuer une obfuscation. À ce stade, la mémoire tampon est entièrement ou partiellement remplie par VmPreReadCallback et par ReadProcessMemory. Le rappel est appelé uniquement si VmStartCallback a retourné S_FALSE.

DbgHelp 6.2 et versions antérieures : Cette valeur n’est pas prise en charge.

Configuration requise

Condition requise Valeur
En-tête minidumpapiset.h (inclure DbgHelp.h)
Composant redistribuable DbgHelp.dll 5.1 ou version ultérieure

Voir aussi

MINIDUMP_CALLBACK_INPUT

MiniDumpCallback