Função EtwActivityIdControl (wdm.h)

A função EtwActivityIdControl cria, consulta e define o identificador de atividade atual.

Sintaxe

NTSTATUS EtwActivityIdControl(
  [in]      ULONG  ControlCode,
  [in, out] LPGUID ActivityId
);

Parâmetros

[in] ControlCode

O parâmetro ControlCode pode ser um dos valores definidos a seguir.

Valor	Significado
EVENT_ACTIVITY_CTRL_GET_ID	Retorna o identificador de atividade do thread atual no parâmetro ActivityId .
EVENT_ACTIVITY_CTRL_SET_ID	Define o identificador de atividade do thread atual como o valor especificado em ActivityId. Observe que a ActivityId passada para essa função não precisa necessariamente ser criada por EVENT_ACTIVITY_CTRL_CREATE_ID ou código de controle EVENT_ACTIVITY_CTRL_CREATE_SET_ID . Você pode usar qualquer valor que se ajuste dentro de um GUID, incluindo qualquer valor local disponível que atenda à sua necessidade de algum tipo de identificador de atividade.
EVENT_ACTIVITY_CTRL_CREATE_ID	Cria um novo identificador e define o parâmetro ActivityId como o valor do novo identificador.
EVENT_ACTIVITY_CTRL_GET_SET_ID	Define o identificador de atividade do thread atual como o valor especificado em ActivityId e retorna ActivityId com o valor do identificador de atividade do thread antes da chamada de função.
EVENT_ACTIVITY_CTRL_CREATE_SET_ID	Copia o identificador de atividade do thread atual. Cria um novo identificador e define o identificador de atividade do thread atual como o novo valor. Retorna ActivityId com o valor do identificador de atividade do thread antes da chamada de função.

[in, out] ActivityId

O identificador que indica a atividade associada ao evento. O parâmetro ActivityId fornece uma maneira de agrupar eventos relacionados e é usado no rastreamento de ponta a ponta.

Retornar valor

EtwActivityIdControl retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado.

Comentários

Os identificadores de atividade fornecem um método de vinculação de eventos separados em um thread comum de computação. Uma atividade é um item de trabalho executado por um aplicativo e ou um driver. O conceito de atividade é um componente principal no rastreamento de ponta a ponta.

Os chamadores de EtwActivityIdControl devem estar em execução no IRQL < DISPATCH_LEVEL, a menos que o ControlCode seja EVENT_ACTIVITY_CTRL_CREATE_ID, nesse caso, a função pode ser chamada em qualquer IRQL.

Use a função EtwActivityIdControlKernel para consultar ou definir threads de kernel de identificadores de atividade.

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe; Ntdll.dll
IRQL	Consulte a seção Comentários

Confira também

EtwActivityIdControlKernel