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 seguintes valores definidos.

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 no ActivityId. Observe que o ActivityId que você passa para essa função não precisa necessariamente ser um criado pelo código de controle EVENT_ACTIVITY_CTRL_CREATE_ID ou 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 para o valor do novo identificador.
EVENT_ACTIVITY_CTRL_GET_SET_ID	Define o identificador de atividade do thread atual como o valor especificado em ActivityIde 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.

Valor de retorno

etwActivityIdControl retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado.

Observações

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 < DISPATCH_LEVEL IRQL, 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
da Plataforma de Destino	Universal
cabeçalho	wdm.h (include Wdm.h, Ntddk.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe; Ntdll.dll
IRQL	Consulte a seção Comentários

Consulte também

etwActivityIdControlKernel