Compartir a través de

Función IoSetActivityIdIrp (ntddk.h)

  • Artículo

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 ETW no estaba disponible.
STATUS_UNSUCCESSFUL El proveedor de seguimiento de E/S no se ha habilitado en irP.

Comentarios

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 Value
Cliente mínimo compatible Disponible a partir de Windows 8.
Plataforma de destino Universal
Encabezado ntddk.h (incluya Ntddk.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL Cualquier nivel si se pasa un GUID; de lo contrario, PASSIVE_LEVEL.