énumération MINIDUMP_CALLBACK_TYPE (minidumpapiset.h)

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