Função EtwWriteString (wdm.h)
A função EventWriteString é uma função de rastreamento que você pode usar quando nenhum dado sofisticado é necessário. Essa função é semelhante a uma instrução de impressão de depuração.
Sintaxe
NTSTATUS EtwWriteString(
[in] REGHANDLE RegHandle,
[in] UCHAR Level,
[in] ULONGLONG Keyword,
[in, optional] LPCGUID ActivityId,
[in] PCWSTR String
);
Parâmetros
[in] RegHandle
Um ponteiro para o identificador de registro do provedor de eventos, que é retornado pela função EtwRegister se o registro do provedor de eventos for bem-sucedido.
[in] Level
O nível no qual o evento está ativo.
[in] Keyword
A palavra-chave do evento. Uma palavra-chave é uma máscara de bits que faz instruções gerais sobre a categoria do evento ou erro. Como a palavra-chave é uma máscara de bits, você pode aplicar mais de uma palavra-chave a um único evento. Você pode definir as palavras-chave e as posições de bit ou usar palavras-chave padrão do Windows ou usar a combinação de suas próprias palavras-chave e as palavras-chave do Windows.
[in, optional] ActivityId
O identificador que indica a atividade associada ao evento. O ActivityId fornece uma maneira de agrupar eventos relacionados e é usado no rastreamento de ponta a ponta. Esse identificador é opcional e pode ser NULL.
[in] String
Uma cadeia de caracteres terminada em nulo (WCHAR).
Valor de retorno
A função retornará STATUS_SUCCESS se o evento for publicado com êxito.
Observações
Como a cadeia de caracteres produzida por função EventWriteString não é localizável, essa função não é recomendada para uso no código de produção. Essa função não deve ser usada para registrar eventos altamente visíveis.
Você pode chamar EtwWriteString em qualquer IRQL. No entanto, quando IRQL é maior que APC_LEVEL, todos os dados passados para as funções EtwWrite, EtwWriteEx, EtwWriteStringe EtwWriteTransfer não devem ser pagináveis. Ou seja, qualquer rotina de modo kernel que esteja em execução no IRQL maior que APC_LEVEL não pode acessar a memória paginável. Os dados passados para as funções EtwWrite, EtwWriteEx, EtwWriteStringe EtwWriteTransfer devem residir na memória do espaço do sistema, independentemente do que seja o IRQL.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores do Windows. |
| da Plataforma de Destino | Universal |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | Qualquer nível (seção Ver Comentários.) |