Partilhar via

Função WmiTraceMessage (wdm.h)

A rotina WmiTraceMessage adiciona uma mensagem ao log de saída de uma sessão de rastreamento de software WPP .

Sintaxe

NTSTATUS WmiTraceMessage(
  [in] TRACELOGGER_HANDLE LoggerHandle,
  [in] ULONG              MessageFlags,
  [in] LPCGUID            MessageGuid,
  [in] USHORT             MessageNumber,
       ...                
);

Parâmetros

[in] LoggerHandle

Especifica um identificador de rastreamento para uma sessão de rastreamento de software.

[in] MessageFlags

Especifica um OR bit a bit de um ou mais sinalizadores de mensagem. Consulte a seção Comentários para obter detalhes.

[in] MessageGuid

Especifica um GUID que identifica a classe de mensagens de rastreamento de software.

[in] MessageNumber

Identifica o subtipo da mensagem. O significado dos subtipos é específico para a classe de rastreamento de software e o provedor.

[in] ...

Fornece uma lista necessária de parâmetros de mensagem que especificam um conjunto de partes de mensagem. Os parâmetros são organizados como uma sequência de pares de parâmetros, em que cada par especifica uma parte da mensagem completa. Cada par de parâmetros consiste em um ponteiro PVOID para dados, seguido imediatamente por um valor size_t que especifica o comprimento dos dados. A lista de parâmetros deve ser encerrada por um ponteiro PVOID NULL seguido por um size_t(0).

Valor de retorno

WmiTraceMessage retorna um dos seguintes valores:

Código de retorno Description
STATUS_SUCCESS
 A operação foi concluída com êxito.
STATUS_INVALID_HANDLE
 LoggerHandle não é um identificador de rastreamento de software válido.
STATUS_NO_MEMORY
 Não há memória de buffer suficiente para registrar a mensagem em log. Consulte a seção Comentários.
Outro valor NTSTATUS
 Ocorreu um erro interno.

Observações

Um chamador pode usar WmiTraceMessage ou WmiTraceMessageVa para adicionar uma mensagem ao log de saída de uma sessão de rastreamento de software WPP. O WmiTraceMessage simplifica o código de um chamador manipulando o mecanismo de lista de variáveis antes de chamar WmiTraceMessageVa.

Um chamador pode definir os seguintes sinalizadores de mensagem:

Flag Description
TRACE_MESSAGE_SEQUENCE Inclua um número de sequência na mensagem. O sequenciamento de mensagens só poderá ser usado se estiver definido para a sessão de rastreamento de software especificada pelo LoggerHandle.
TRACE_MESSAGE_GUID MessageGuid especifica um GUID que identifica uma classe de rastreamento de software. Esse sinalizador deve ser definido.
TRACE_MESSAGE_TIMESTAMP Inclua um carimbo de data/hora na mensagem.
TRACE_MESSAGE_PERFORMANCE_TIMESTAMP Esse sinalizador não é implementado e está obsoleto. Ele não deve ser usado.
TRACE_MESSAGE_SYSTEMINFO Inclua o TID (identificador de thread) e o PID (identificador de processo) na mensagem.
 

Uma mensagem não será registrada se uma das seguintes opções for verdadeira:

  • O tamanho total, em bytes, dos dados da mensagem e do cabeçalho da mensagem é maior do que o tamanho dos buffers de mensagens individuais alocados para uma sessão de rastreamento de software. (O tamanho máximo do cabeçalho da mensagem é de 48 bytes.)
  • Todos os buffers de mensagem alocados para a sessão de rastreamento de software estão cheios.
O WmiTraceMessage é executado no IRQL do chamador.

Requirements

Requirement Value
Cliente mínimo suportado Disponível no Windows XP e versões posteriores do Windows.
da Plataforma de Destino Universal
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
de DLL NtosKrnl.exe
IRQL Consulte a seção Comentários.

Consulte também

IoWMIWriteEvent

TRACE_INFORMATION_CLASS

WmiFireEvent

WmiQueryTraceInformation

WmiTraceMessageVa

  • Last updated on