Função WmiTraceMessageVa (wdm.h)
A rotina WmiTraceMessageVa adiciona uma mensagem ao log de saída de uma sessão de rastreamento de software WPP .
Sintaxe
NTSTATUS WmiTraceMessageVa(
[in] TRACELOGGER_HANDLE LoggerHandle,
[in] ULONG MessageFlags,
[in] LPCGUID MessageGuid,
[in] USHORT MessageNumber,
[in] va_list MessageArgList
);
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 uma classe de rastreamento de software.
[in] MessageNumber
Identifica o subtipo de mensagem. O significado dos subtipos é específico para a classe de rastreamento de software e o provedor.
[in] MessageArgList
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 ULONG que especifica o comprimento dos dados. A lista de parâmetros deve ser encerrada por um ponteiro PVOID NULL seguido por um ULONG(0).
Retornar valor
WmiTraceMessageVa retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
|
A operação foi concluída com sucesso. |
|
LoggerHandle não é um identificador de rastreamento de software válido. |
|
Não há memória de buffer suficiente para registrar a mensagem em log. Consulte a seção Comentários para obter mais informações. |
|
Ocorreu um erro interno. |
Comentários
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:
| Sinalizador | Descrição |
|---|---|
| TRACE_MESSAGE_SEQUENCE | Inclua um número de sequência na mensagem. O sequenciamento de mensagens só poderá ser usado se estiver habilitado para a sessão de rastreamento de software especificada por 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 identificador de thread (TID) e o PID (identificador de processo) na mensagem. |
WmiTraceMessageVa não registrará a mensagem 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.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows XP e versões posteriores do Windows. |
| Plataforma de Destino | Universal |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Consulte a seção Observações. |