Función IoSetActivityIdIrp (ntddk.h)

La rutina IoSetActivityIdIrp asocia un identificador de actividad a un IRP.

Sintaxis

NTSTATUS IoSetActivityIdIrp(
  [in]           PIRP    Irp,
  [in, optional] LPCGUID Guid
);

Parámetros

[in] Irp

IRP al que se va a asociar el identificador de actividad.

[in, optional] Guid

Puntero al GUID que representa el identificador que se va a almacenar en el IRP. Si es NULL, IoSetActivityIdIrp intenta recuperar el identificador de actividad del subproceso actual si era el subproceso que emitió originalmente la solicitud.

Valor devuelto

IoSetActivityIdIrp devuelve STATUS_SUCCESS si la llamada se realiza correctamente. Entre los posibles valores devueltos de error se incluyen los siguientes.

Código devuelto	Descripción
STATUS_NOT_SUPPORTED	No se proporcionó ningún GUID y el identificador de actividad de ETW no estaba disponible.
STATUS_UNSUCCESSFUL	El proveedor de seguimiento de E/S no se ha habilitado en el IRP.

Observaciones

Los controladores deben usar IoSetActivityIdIrp solo en irP que se han asignado mediante ioAllocateIrp (y liberarse mediante IoFreeIrp). De lo contrario, puede producirse una pérdida de memoria.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible a partir de Windows 8.
de la plataforma de destino de	Universal
encabezado de	ntddk.h (incluya Ntddk.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	Cualquier nivel si se pasa un GUID; de lo contrario, PASSIVE_LEVEL.