TraceSetInformation, fonction (evntrace.h)

La fonction TraceSetInformation configure les paramètres de session de suivi des é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 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, mais la longueur de la commande est 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 pour 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 d’événements de noyau pour lesquels le suivi de pile est activé. Pour désactiver le suivi de pile, appelez cette fonction avec InformationClass définie sur TraceStackTracingInfo et InformationLength définie sur 0.

La section données étendues de l’événement inclut la pile des appels. La classe StackWalk_Event MOF 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 à pied de la pile du noyau sur x64, définissez la valeur de DisablePagingExecutive Registre Memory Management 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. Cette opération ne doit être effectuée qu’à des fins de diagnostic temporaire, car elle augmente l’utilisation de la mémoire du système.

Spécifications

Voir aussi

TRACE_QUERY_INFO_CLASS

TraceQueryInformation