TraceSetInformation, fonction (evntrace.h)

La fonction TraceSetInformation configure les paramètres de session de suivi d’événements.

Syntaxe

ULONG WMIAPI TraceSetInformation(
       CONTROLTRACE_ID  TraceId,
  [in] TRACE_INFO_CLASS InformationClass,
  [in] PVOID            TraceInformation,
  [in] ULONG            InformationLength
);

Paramètres

TraceId

[in] InformationClass

Classe d’informations à activer ou désactiver. Les informations capturées par la classe sont incluses dans la section de données étendues de l’événement. Pour obtenir la liste des classes d’informations que vous pouvez activer, consultez l’énumération TRACE_QUERY_INFO_CLASS .

[in] TraceInformation

Pointeur vers des données spécifiques à la classe d’informations. La classe d’informations détermine le contenu de ce paramètre.

[in] InformationLength

Taille, en octets, des données dans la mémoire tampon TraceInformation .

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

• ERROR_BAD_LENGTH

  Le programme a émis une commande de longueur incorrecte. Cette erreur est retournée si le paramètre InformationLength est inférieur à une taille minimale.

• ERROR_INVALID_PARAMETER

  Le paramètre est incorrect.

• ERROR_NOT_SUPPORTED

  La demande n'est pas prise en charge.

• Autres

  Utilisez FormatMessage pour obtenir la chaîne de message de l’erreur retournée.

Remarques

Appelez cette fonction après avoir appelé StartTrace.

Si le paramètre InformationClass est défini sur TraceStackTracingInfo, l’appel de cette fonction active le suivi de pile des événements de noyau spécifiés. Les appels suivants à cette fonction remplacent la liste précédente des événements du noyau pour lesquels le suivi de pile est activé. Pour désactiver le suivi de la pile, appelez cette fonction avec InformationClass défini sur TraceStackTracingInfo et InformationLength défini sur 0.

La section de données étendues de l’événement inclut la pile des appels. La classe MOF StackWalk_Event définit la disposition des données étendues.

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 à pas de la pile du noyau sur x64, définissez la valeur de Registre Gestion de la DisablePagingExecutive mémoire sur 1. La DisablePagingExecutive valeur de 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.

Configuration requise

Voir aussi

TRACE_QUERY_INFO_CLASS

TraceQueryInformation