Función EtwActivityIdControl (wdm.h)

La función EtwActivityIdControl crea, consulta y establece el identificador de actividad actual.

Sintaxis

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

Parámetros

[in] ControlCode

El parámetro ControlCode puede ser uno de los siguientes valores definidos.

Valor	Significado
EVENT_ACTIVITY_CTRL_GET_ID	Devuelve el identificador de actividad del subproceso actual en el parámetro activityId de .
EVENT_ACTIVITY_CTRL_SET_ID	Establece el identificador de actividad del subproceso actual en el valor especificado en ActivityId. Tenga en cuenta que el ActivityId que se pasa a esta función no tiene que ser necesariamente uno creado por EVENT_ACTIVITY_CTRL_CREATE_ID o EVENT_ACTIVITY_CTRL_CREATE_SET_ID código de control. Puede usar cualquier valor que se ajuste dentro de un GUID, incluido cualquier valor local disponible que serviría a la necesidad de algún tipo de identificador de actividad.
EVENT_ACTIVITY_CTRL_CREATE_ID	Crea un nuevo identificador y establece el parámetro ActivityId en el valor del nuevo identificador.
EVENT_ACTIVITY_CTRL_GET_SET_ID	Establece el identificador de actividad del subproceso actual en el valor especificado en ActivityIdy, a continuación, devuelve ActivityId con el valor del identificador de actividad del subproceso antes de la llamada de función.
EVENT_ACTIVITY_CTRL_CREATE_SET_ID	Copia el identificador de actividad del subproceso actual. Crea un nuevo identificador y establece el identificador de actividad del subproceso actual en el nuevo valor. Devuelve ActivityId con el valor del identificador de actividad del subproceso antes de la llamada de función.

[in, out] ActivityId

Identificador que indica la actividad asociada al evento. El parámetro ActivityId proporciona una manera de agrupar eventos relacionados y se usa en el seguimiento de un extremo a otro.

Valor devuelto

etwActivityIdControl devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado.

Observaciones

Los identificadores de actividad proporcionan un método para vincular eventos independientes en un subproceso común de cálculo. Una actividad es un elemento de trabajo realizado por una aplicación o un controlador. El concepto de actividad es un componente principal en el seguimiento de un extremo a otro.

Los autores de llamadas de EtwActivityIdControl deben ejecutarse en irQL < DISPATCH_LEVEL, a menos que el controlCode de sea EVENT_ACTIVITY_CTRL_CREATE_ID, en cuyo caso se puede llamar a la función en cualquier IRQL.

Use la función EtwActivityIdControlKernel para consultar o establecer los identificadores de actividad de los subprocesos del kernel.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	wdm.h (include Wdm.h, Ntddk.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe; Ntdll.dll
irQL	Consulte la sección Comentarios.

Consulte también

etwActivityIdControlKernel