WmiQueryTraceInformation, fonction (wdm.h)

Article
08/08/2023

La routine WmiQueryTraceInformation retourne des informations sur une trace d’événement WMI.

Syntaxe

NTSTATUS WmiQueryTraceInformation(
  [in]            TRACE_INFORMATION_CLASS TraceInformationClass,
  [out]           PVOID                   TraceInformation,
  [in]            ULONG                   TraceInformationLength,
  [out, optional] PULONG                  RequiredLength,
  [in, optional]  PVOID                   Buffer
);

Paramètres

[in] TraceInformationClass

Spécifie un énumérateur TRACE_INFORMATION_CLASS qui indique le type d’informations à retourner sur une trace d’événement.

[out] TraceInformation

Pointeur vers une mémoire tampon de sortie allouée par l’appelant où la routine retourne les informations de trace d’événement spécifiées par TraceInformationClass.

[in] TraceInformationLength

Spécifie la taille, en octets, de la mémoire tampon TraceInformation .

[out, optional] RequiredLength

Pointeur vers la valeur retournée par la routine qui spécifie la taille requise, en octets, de la mémoire tampon TraceInformation . L’appelant doit définir RequiredLength sur NULL s’il n’utilise pas les informations de longueur requises.

[in, optional] Buffer

Pointeur vers les informations d’entrée spécifiques à la requête qu’un appelant fournit. Si les informations fournies par l’appelant ne sont pas requises, l’appelant doit définir Buffer sur NULL.

Valeur retournée

Code de retour	Description
STATUS_SUCCESS	Succès
STATUS_INFO_LENGTH_MISMATCH	La taille de la mémoire tampon TraceInformation n’est pas égale à la taille requise pour les informations de trace d’événements spécifiées.
STATUS_INVALID_HANDLE	Le handle de trace spécifié par le membre HistoricalContext de la (PWNODE_HEADER)Buffer n’est pas valide.
STATUS_INVALID_INFO_CLASS	Le type spécifié d’informations de trace d’événement n’est pas valide.
STATUS_INVALID_PARAMETER	Le nom de la trace d’événement, fourni avec une requête pour retourner un handle de trace en fonction de son nom, n’est pas valide.
STATUS_INVALID_PARAMETER_MIX	L’appelant n’a pas fourni les informations requises pour les informations de trace d’événement spécifiées.
STATUS_MORE_ENTRIES	La mémoire tampon TraceInformation n’est pas assez grande pour contenir un tableau de tous les handles de trace d’événements valides.
STATUS_NOT_FOUND	Un enregistreur d’événements global est introuvable.

Remarques

Pour chaque type d’informations de suivi d’événement spécifié par TraceInformationClass, le tableau suivant fournit :

Critères des entrées
Informations retournées par WmiQueryTraceInformation dans la mémoire tampon TraceInformation

Valeur de TraceClassInformation	Critères des entrées	Informations retournées
TraceIdClass	TraceInformationLength est égal à la valeur de sizeof(ULONG). La taille, en octets de la mémoire tampon TraceInformation est supérieure ou égale à la valeur de sizeof(ULONG). Le membre HistoricalContext de (PWNODE_HEADER)Buffer spécifie un handle de trace d’événement.	(PULONG)TraceInformation* est défini sur l’ID d’enregistreur d’événements du handle de trace d’événement.
TraceHandleClass	TraceInformationLength est égal à la valeur de sizeof(TRACEHANDLE). La taille, en octets de la mémoire tampon TraceInformation doit être supérieure ou égale à la valeur de sizeof(TRACEHANDLE). (PULONG)Buffer* est défini sur un ID d’enregistreur d’événements.	(PTRACEHANDLE)TraceInformation* est défini sur un handle de trace d’événement pour l’enregistreur d’événements spécifié. Si l’ID d’enregistreur d’événements spécifié est égal à zéro, un handle de trace d’événement pour l’enregistreur d’événements est retourné.
TraceEnableFlagsClass	TraceInformationLength est supérieur ou égal à la valeur de sizeof(ULONG). La taille, en octets de la mémoire tampon TraceInformation doit être supérieure ou égale à la valeur de sizeof(ULONG). Le membre HistoricalContext de (PWNODE_HEADER)Buffer spécifie un handle de trace d’événement.	(PULONG)TraceInformation* est défini sur les indicateurs d’activation définis pour le handle de trace d’événement spécifié.
TraceEnableLevelClass	TraceInformationLength est défini au-dessus ou égal à la valeur de sizeof(ULONG). La taille, en octets de la mémoire tampon TraceInformation doit être supérieure ou égale à la valeur de sizeof(ULONG). Le membre HistoricalContext de (PWNODE_HEADER)Buffer spécifie un handle de trace d’événement.	(PULONG)TraceInformation* est défini sur le niveau pour le handle de trace d’événement spécifié.
GlobalLoggerHandleClass	TraceInformationLength est égal à la valeur de sizeof(TRACEHANDLE). La taille, en octets de la mémoire tampon TraceInformation doit être supérieure ou égale à la valeur de sizeof(TRACEHANDLE).	(PTRACEHANDLE)TraceInformation* est défini sur un handle de trace d’événement pour l’enregistreur d’événements.
EventLoggerHandleClass	Uniquement réservé à un usage interne.	Uniquement réservé à un usage interne.
AllLoggerHandlesClass	TraceInformationLength est défini sur la taille, les octets, d’un tableau de valeurs m TRACEHANDLE. La taille, en octets de la mémoire tampon TraceInformation doit être supérieure ou égale à la valeur de (m*sizeof(TRACEHANDLE)).	La mémoire tampon TraceInformation contient un tableau de n handles de trace, où n est le minimum de m, le nombre de handles de trace d’événements fournis par l’appelant et le nombre de handles de trace d’événements valides. La routine retourne une status de STATUS_MORE_ENTRIES si la mémoire tampon TraceInformation est trop petite pour contenir tous les handles de trace.
TraceHandleByNameClass	TraceInformationLength est défini sur la valeur sizeof(TRACEHANDLE). La taille, en octets, de la mémoire tampon TraceInformation doit être supérieure ou égale à la valeur de sizeof(TRACEHANDLE). (PUNICODE_STRING) Buffer spécifie un nom de trace convivial au format Unicode.	(PTRACEHANDLE)TraceInformation* est défini sur le handle de trace d’événement associé au nom convivial spécifié.

Si l’appelant fournit un pointeur RequiredLength non NULL, WmiQueryTraceInformation retourne également la longueur requise pour les informations de trace d’événements spécifiées.

WmiQueryTraceInformation s’exécute à l’IRQL de l’appelant.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows XP et versions ultérieures de Windows.
Plateforme cible	Universal
En-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Consultez la section Notes.

Voir aussi

IoWmiWriteEvent

TRACE_INFORMATION_CLASS

WmiFireEvent

WmiTraceMessage

WmiTraceMessageVa