Share via

structure ENABLE_TRACE_PARAMETERS_V1 (evntrace.h)

  • Article

La structure ENABLE_TRACE_PARAMETERS_V1 contient des informations utilisées pour activer un fournisseur via EnableTraceEx2. Cette structure est obsolète. Utilisez ENABLE_TRACE_PARAMETERS à la place.

Syntaxe

typedef struct _ENABLE_TRACE_PARAMETERS_V1 {
  ULONG                    Version;
  ULONG                    EnableProperty;
  ULONG                    ControlFlags;
  GUID                     SourceId;
  PEVENT_FILTER_DESCRIPTOR EnableFilterDesc;
} ENABLE_TRACE_PARAMETERS_V1, *PENABLE_TRACE_PARAMETERS_V1;

Membres

Version

Définissez sur ENABLE_TRACE_PARAMETERS_VERSION (1).

EnableProperty

Informations facultatives que ETW peut inclure lors de l’écriture de l’événement. Les données sont écrites dans la section élément de données étendu de l’événement. Pour inclure les informations facultatives, spécifiez un ou plusieurs des indicateurs suivants : sinon, définissez sur zéro.

  • EVENT_ENABLE_PROPERTY_SID

    Incluez dans les données étendues l’identificateur de sécurité (SID) de l’utilisateur.

  • EVENT_ENABLE_PROPERTY_TS_ID

    Incluez dans les données étendues l’identificateur de session de terminal.

  • EVENT_ENABLE_PROPERTY_STACK_TRACE

    Ajoutez une trace de pile d’appels aux données étendues des événements écrits à l’aide d’EventWrite.

    Notes

    ETW supprime l’événement si la taille totale de l’événement dépasse 64 000. Si le fournisseur journalne des événements de taille maximale de 64 000, il est possible que l’activation de la capture de pile entraîne la perte de l’événement.

    Si la pile est plus longue que le nombre maximal d’images (192), les images sont coupées du bas de la pile.

    Pour les consommateurs, les événements incluent le EVENT_EXTENDED_ITEM_STACK_TRACE32 ou EVENT_EXTENDED_ITEM_STACK_TRACE64 élément étendu. Notez que les consommateurs 32 bits peuvent recevoir des traces de pile 64 bits de processus 64 bits.

ControlFlags

Réservé. Définit la valeur 0.

SourceId

GUID qui identifie de manière unique l’appelant qui active ou désactive le fournisseur. Si le fournisseur n’implémente pas EnableCallback, le GUID n’est pas utilisé.

EnableFilterDesc

Une structure EVENT_FILTER_DESCRIPTOR qui pointe vers les données de filtre. Le fournisseur utilise des données de filtre pour empêcher l’écriture d’événements qui correspondent aux critères de filtre dans la session. Le fournisseur détermine la disposition des données et la façon dont il applique le filtre aux données de l’événement. Une session ne peut passer qu’un seul filtre au fournisseur.

Une session peut appeler la fonction TdhEnumerateProviderFilters pour déterminer les filtres schématisés qu’elle peut passer au fournisseur.

Notes

ENABLE_TRACE_PARAMETERS_V1 est obsolète. La structure ENABLE_TRACE_PARAMETERS est une structure de version 2 qui remplace la structure ENABLE_TRACE_PARAMETERS_V1 .

En règle générale, sur les ordinateurs 64 bits, vous ne pouvez pas capturer la pile du noyau dans certains contextes lorsque les erreurs de page ne sont pas autorisées. Pour activer la marche à pied de la pile du noyau sur x64, définissez la valeur de Registre Gestion de la DisablePagingExecutive mémoire sur 1. La DisablePagingExecutive valeur du Registre se trouve sous la clé de Registre suivante : HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management. Cela ne doit être effectué qu’à des fins de diagnostic temporaire, car cela augmente l’utilisation de la mémoire du système.

Spécifications

   
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
En-tête evntrace.h

Voir aussi

ENABLE_TRACE_PARAMETERS

EVENT_FILTER_DESCRIPTOR

EnableTraceEx2