Constantes do agente do kernel NT
Use as constantes a seguir para identificar a sessão do Agente do Kernel NT.
Constante | Descrição |
---|---|
SystemTraceControlGuid | O GUID de controle para a sessão de rastreamento de eventos do Agente do Kernel NT. |
KERNEL_LOGGER_NAME | O nome da sessão de rastreamento de eventos do Agente do Kernel NT. |
A sessão do Agente do Kernel NT é a única sessão que pode aceitar eventos de provedores de eventos do kernel. A sessão do Agente do Kernel NT não aceita eventos de outros provedores. Se você quiser capturar eventos e eventos do kernel de outros provedores, deverá usar duas sessões separadas e o consumidor precisará mesclar os eventos dos arquivos de log para fornecer resultados de ponta a ponta.
O ETW usa a macro DEFINE_GUID para definir GUIDs. Para usar SystemTraceControlGuid em seu código, você deve incluir #define INITGUID antes de incluir Evntrace.h. Em seguida, o compilador transformará o DEFINE_GUID em um GUID constante.
Os valores a seguir definem os GUIDs de classe possíveis para eventos de kernel que uma sessão do Agente do Kernel NT pode rastrear. Você pode passar os GUIDs de classe para a função SetTraceCallback para configurar o processamento especial para cada classe de evento.
Classe | GUID |
---|---|
alpc |
|
do DiskIo |
|
HWConfig e SystemConfig |
|
FileIo |
|
de imagem |
|
PageFault_V2 |
|
PerfInfo |
|
Process |
|
do Registro |
|
SplitIo |
|
TcpIp |
|
Thread |
|
UdpIp |
|
Observações
Para usar os GUIDs, copie as definições de GUID que você deseja usar para o código-fonte. Você deve incluir #define INITGUID antes das definições incluídas no código-fonte para que o compilador transforme o DEFINE_GUID em um GUID constante. Por exemplo
#define INITGUID
DEFINE_GUID ( /* 3d6fa8d1-fe05-11d0-9dda-00c04fd7ba7c */
ThreadGuid,
0x3d6fa8d1,
0xfe05,
0x11d0,
0x9d, 0xda, 0x00, 0xc0, 0x4f, 0xd7, 0xba, 0x7c
);
DEFINE_GUID ( /* 3d6fa8d0-fe05-11d0-9dda-00c04fd7ba7c */
ProcessGuid,
0x3d6fa8d0,
0xfe05,
0x11d0,
0x9d, 0xda, 0x00, 0xc0, 0x4f, 0xd7, 0xba, 0x7c
);
Como alternativa, você pode definir o GUID constante para as definições guid por conta própria. Por exemplo
static const GUID ThreadGuid =
{ 0x3d6fa8d0, 0xfe05, 0x11d0, { 0x9d, 0xda, 0x00, 0xc0, 0x4f, 0xd7, 0xba, 0x7c } };