Expandir Minimizar

IoSetActivityIdIrp routine

The IoSetActivityIdIrp routine associates an activity ID with an IRP.

Syntax


NTSTATUS IoSetActivityIdIrp(
  _In_      PIRP Irp,
  _In_opt_  LPGUID Guid
);

Parameters

Irp [in]

The IRP to associate the activity ID with.

Guid [in, optional]

A pointer to the GUID that represents the ID to store in the IRP. If NULL, IoSetActivityIdIrp attempts to retrieve the activity ID from the current thread if it was the thread that originally issued the request.

Return value

IoSetActivityIdIrp returns STATUS_SUCCESS if the call is successful. Possible error return values include the following.

Return codeDescription
STATUS_NOT_SUPPORTED

No GUID was provided and the ETW activity ID was unavailable.

STATUS_UNSUCCESSFUL

The I/O tracing provider has not been enabled on the IRP.

 

Remarks

Drivers should use IoSetActivityIdIrp only on IRPs that have been allocated using IoAllocateIrp (and freed using IoFreeIrp). Otherwise, memory leakage may result.

Requirements

Version

Available starting with Windows 8.

Header

Ntddk.h (include Ntddk.h)

Library

Ntoskrnl.lib

IRQL

Any level if a GUID is passed in, otherwise PASSIVE_LEVEL.

 

 

Send comments about this topic to Microsoft

Mostrar:
© 2014 Microsoft