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

O palavra-chave para o evento. Um palavra-chave é uma máscara de bits que faz instruções gerais sobre a categoria do evento ou erro. Como o palavra-chave é uma máscara de bits, você pode aplicar mais de um 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. A ActivityId fornece uma maneira de agrupar eventos relacionados e é usada no rastreamento de ponta a ponta. Esse identificador é opcional e pode ser NULL.

[in] String

Uma cadeia de caracteres terminada em nulo (WCHAR).

Retornar valor

A função retornará STATUS_SUCCESS se o evento for publicado com êxito.

Comentários

Como a cadeia de caracteres produzida pela 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, EtwWriteString e EtwWriteTransfer não devem ser pagináveis. Ou seja, qualquer rotina de modo kernel 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, EtwWriteString e EtwWriteTransfer devem residir na memória do espaço do sistema, independentemente do que seja o IRQL.

Requisitos

Confira também

EtwWrite

EtwWriteEx

EtwWriteTransfer