IDebugControl4 ::GetStoredEventInformation, méthode (dbgeng.h)

Article
02/06/2025

La méthode GetStoredEventInformation récupère des informations sur un événement d’intérêt disponible dans la cible actuelle.

Syntaxe

HRESULT GetStoredEventInformation(
  [out]           PULONG Type,
  [out]           PULONG ProcessId,
  [out]           PULONG ThreadId,
  [out, optional] PVOID  Context,
  [in]            ULONG  ContextSize,
  [out, optional] PULONG ContextUsed,
  [out, optional] PVOID  ExtraInformation,
  [in]            ULONG  ExtraInformationSize,
  [out, optional] PULONG ExtraInformationUsed
);

Paramètres

[out] Type

Reçoit le type de l’événement stocké. Pour obtenir la liste des types possibles, consultez DEBUG_EVENT_XXX.

[out] ProcessId

Reçoit l’ID de processus du processus dans lequel l’événement s’est produit. Si ces informations ne sont pas disponibles, DEBUG_ANY_ID sera retourné à la place.

[out] ThreadId

Reçoit l’ID de thread du thread dans lequel le dernier événement s’est produit. Si ces informations ne sont pas disponibles, DEBUG_ANY_ID sera retourné à la place.

[out, optional] Context

Reçoit le contexte de thread de l’événement stocké. Le type du contexte de thread est la structure CONTEXT du processeur effectif de la cible au moment de l’événement. La mémoire tampon contexte doit être suffisamment grande pour contenir cette structure. Si de contexte est NULL, ces informations ne sont pas retournées.

[in] ContextSize

Spécifie la taille, en octets, de la mémoire tampon qui Context spécifie.

[out, optional] ContextUsed

Reçoit la taille en octets du contexte. Si ContextUsed est NULL, ces informations ne sont pas retournées.

[out, optional] ExtraInformation

Reçoit des informations supplémentaires sur l’événement. Le contenu de ces informations supplémentaires dépend du type de l’événement. Si ExtraInformation est NULL, ces informations ne sont pas retournées.

[in] ExtraInformationSize

Spécifie la taille, en octets, de la mémoire tampon qui ExtraInformation spécifie.

[out, optional] ExtraInformationUsed

Reçoit la taille en octets d’informations supplémentaires. Si ExtraInformationUsed est NULL, ces informations ne sont pas retournées.

Valeur de retour

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez valeurs de retour.

Retourner le code	Description
S_OK	La méthode a réussi.

Remarques

De nombreuses cibles n’ont pas d’intérêt.

Si la cible est un fichier minidump en mode utilisateur, le générateur de fichiers de vidage peut stocker un événement supplémentaire. En règle générale, il s’agit de l’événement qui a provoqué le générateur pour enregistrer le fichier de vidage.

Pour plus d’informations, consultez la rubrique Informations sur les événements.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	dbgeng.h (include Dbgeng.h, Ntddk.h)

Voir aussi

GetLastEventInformation

IDebugControl4

Partager via