Constantes do agente de 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 de Kernel do NT. |
KERNEL_LOGGER_NAME | O nome da sessão de rastreamento de eventos do Agente de Kernel do NT. |
A sessão do Agente de Kernel do NT é a única sessão que pode aceitar eventos de provedores de eventos de kernel. A sessão do Agente de Kernel do NT não aceita eventos de outros provedores. Se você quiser capturar eventos e eventos de 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 de 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 |
|
DiskIo |
|
HWConfig e SystemConfig |
|
Fileio |
|
Imagem |
|
PageFault_V2 |
|
PerfInfo |
|
Processar |
|
Registro |
|
SplitIo |
|
Tcpip |
|
Thread |
|
UdpIp |
|
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 de GUID por conta própria. Por exemplo,
static const GUID ThreadGuid =
{ 0x3d6fa8d0, 0xfe05, 0x11d0, { 0x9d, 0xda, 0x00, 0xc0, 0x4f, 0xd7, 0xba, 0x7c } };