Méthode IDebugControl4 ::GetStoredEventInformation (dbgeng.h)

Article
08/07/2023

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 sont retournées à 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 sont retournées à 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 de contexte doit être suffisamment grande pour contenir cette structure. Si Context a la valeur NULL, ces informations ne sont pas retournées.

[in] ContextSize

Spécifie la taille, en octets, de la mémoire tampon spécifiée par Context .

[out, optional] ContextUsed

Reçoit la taille en octets du contexte. Si ContextUsed a la valeur 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 a la valeur NULL, ces informations ne sont pas retournées.

[in] ExtraInformationSize

Spécifie la taille, en octets, de la mémoire tampon spécifiée par ExtraInformation .

[out, optional] ExtraInformationUsed

Reçoit la taille en octets des informations supplémentaires. Si ExtraInformationUsed a la valeur NULL, ces informations ne sont pas retournées.

Valeur retournée

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

Code de retour	Description
S_OK	La méthode a réussi.

Remarques

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

Si la cible est un fichier minidump en mode utilisateur, le générateur de fichier 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é l’enregistrement du fichier de vidage par le générateur.

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

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dbgeng.h (inclure Dbgeng.h, Ntddk.h)

Voir aussi

GetLastEventInformation

IDebugControl4