Função WmiQueryTraceInformation (wdm.h)

  • Artigo

A rotina de WmiQueryTraceInformation retorna informações sobre umde rastreamento de eventos WMI .

Sintaxe

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

Parâmetros

[in] TraceInformationClass

Especifica um enumerador TRACE_INFORMATION_CLASS que indica o tipo de informação a ser retornado sobre um rastreamento de evento.

[out] TraceInformation

Um ponteiro para um buffer de saída alocado pelo chamador em que a rotina retorna as informações de rastreamento de eventos especificadas por TraceInformationClass.

[in] TraceInformationLength

Especifica o tamanho, em bytes, do buffer TraceInformation.

[out, optional] RequiredLength

Um ponteiro para o valor retornado pela rotina que especifica o tamanho necessário, em bytes, do TraceInformation buffer. O chamador deve definir RequiredLength para NULL se ele não usar as informações de comprimento necessárias.

[in, optional] Buffer

Um ponteiro para as informações de entrada específicas da consulta fornecidas por um chamador. Se as informações fornecidas pelo chamador não forem necessárias, o chamador deverá definir buffer para NULL.

Valor de retorno

Código de retorno Descrição
STATUS_SUCCESS
 Êxito
STATUS_INFO_LENGTH_MISMATCH
 O tamanho do buffer TraceInformation não é igual ao tamanho necessário para as informações de rastreamento de evento especificadas.
STATUS_INVALID_HANDLE
 O identificador de rastreamento especificado pelo membro HistoricalContext do de Buffer de(PWNODE_HEADER) não é válido.
STATUS_INVALID_INFO_CLASS
 O tipo especificado de informações de rastreamento de evento não é válido.
STATUS_INVALID_PARAMETER
 O nome do rastreamento de evento, fornecido com uma consulta para retornar um identificador de rastreamento dado seu nome, não é válido.
STATUS_INVALID_PARAMETER_MIX
 O chamador não forneceu as informações necessárias para as informações de rastreamento de evento especificadas.
STATUS_MORE_ENTRIES
 O buffer TraceInformation não é grande o suficiente para manter uma matriz de todos os identificadores de rastreamento de eventos válidos.
STATUS_NOT_FOUND
 Um agente global não foi encontrado.

Observações

Para cada tipo de informação de rastreamento de evento especificada por TraceInformationClass, a tabela a seguir fornece:

  • Requisitos de entrada
  • Informações que WmiQueryTraceInformation retornam no buffer TraceInformation
Valor de TraceClassInformation Requisitos de entrada Informações retornadas
TraceIdClass TraceInformationLength é igual ao valor de sizeof(ULONG).

O tamanho, em bytes do buffer TraceInformation é maior ou igual ao valor de tamanho de(ULONG).

O membro HistoricalContext do buffer de(PWNODE_HEADER ) especifica um identificador de rastreamento de evento.

 *(PULONG)TraceInformation está definido como a ID do agente do identificador de rastreamento de evento.
TraceHandleClass TraceInformationLength é igual ao valor de sizeof(TRACEHANDLE).

O tamanho, em bytes do buffer TraceInformation deve ser maior ou igual ao valor de sizeof(TRACEHANDLE).

*(PULONG) buffer está definido como uma ID do agente.

 *(PTRACEHANDLE)TraceInformation é definido como um identificador de rastreamento de evento para o agente especificado. Se a ID do agente especificada for zero, um identificador de rastreamento de evento para o agente do kernel será retornado.
TraceEnableFlagsClass TraceInformationLength é maior ou igual ao valor de tamanho de(ULONG).

O tamanho, em bytes do buffer TraceInformation deve ser maior ou igual ao valor de tamanho de(ULONG).

O membro HistoricalContext do buffer de(PWNODE_HEADER ) especifica um identificador de rastreamento de evento.

 *(PULONG)TraceInformation é definido como os sinalizadores de habilitação definidos para o identificador de rastreamento de evento especificado.
TraceEnableLevelClass TraceInformationLength é definido maior ou igual ao valor de tamanho de(ULONG).

O tamanho, em bytes do buffer TraceInformation deve ser maior ou igual ao valor de tamanho de(ULONG).

O membro HistoricalContext do buffer de(PWNODE_HEADER ) especifica um identificador de rastreamento de evento.

 *(PULONG) TraceInformation é definido como o nível do identificador de rastreamento de evento especificado.
GlobalLoggerHandleClass TraceInformationLength é igual ao valor de sizeof(TRACEHANDLE).

O tamanho, em bytes do buffer TraceInformation deve ser maior ou igual ao valor de sizeof(TRACEHANDLE).

 *(PTRACEHANDLE)TraceInformation está definido como um identificador de rastreamento de eventos para o agente global.
EventLoggerHandleClass Somente para uso interno. Somente para uso interno.
AllLoggerHandlesClass TraceInformationLength é definido como o tamanho, bytes, de uma matriz de valores m TRACEHANDLE.

O tamanho, em bytes do buffer TraceInformation deve ser maior ou igual ao valor de (m*sizeof(TRACEHANDLE)).

 O buffer TraceInformation contém uma matriz de n identificadores de rastreamento, em que n é o mínimo de m, o número de identificadores de rastreamento de eventos fornecidos pelo chamador e o número de identificadores de rastreamento de eventos válidos. A rotina retornará um status de STATUS_MORE_ENTRIES se o TraceInformation buffer for muito pequeno para manter todos os identificadores de rastreamento.
TraceHandleByNameClass TraceInformationLength é definido como o valor de sizeof(TRACEHANDLE).

O tamanho, em bytes, do buffer TraceInformation deve ser maior ou igual ao valor de tamanho de(TRACEHANDLE).

(PUNICODE_STRING)Buffer especifica um nome de rastreamento amigável no formato Unicode.

 *(PTRACEHANDLE)TraceInformation está definido como o identificador de rastreamento de evento associado ao nome amigável especificado.
 

Se o chamador fornecer um ponteiro NULL nãoRequiredLength, WmiQueryTraceInformation também retornará o comprimento necessário para as informações de rastreamento de evento especificadas.

WmiQueryTraceInformation é executado no IRQL do chamador.

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível no Windows XP e versões posteriores do Windows.
da Plataforma de Destino Universal
cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca NtosKrnl.lib
de DLL NtosKrnl.exe
IRQL Consulte a seção Comentários.

Consulte também

IoWmiWriteEvent

TRACE_INFORMATION_CLASS

WmiFireEvent

WmiTraceMessage

WmiTraceMessageVa