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 .
EVENT_ACTIVITY_CTRL_SET_ID	Establece el identificador de actividad del subproceso actual en el valor especificado en ActivityId. Tenga en cuenta que 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, incluidos los valores locales disponibles que atenderían 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 ActivityId y, 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.

Comentarios

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 ControlCode 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	Value
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe; Ntdll.dll
IRQL	Consulte la sección Comentarios.

Consulte también

EtwActivityIdControlKernel