structure ENABLE_TRACE_PARAMETERS_V1 (evntrace.h)
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 |