Expand Minimize
This topic has not yet been rated - Rate this topic

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.

 

Requirements

Version

Available starting with Windows 8.

Header

Ntddk.h (include Ntddk.h)

Library

Contained in Ntoskrnl.lib.

IRQL

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

 

 

Send comments about this topic to Microsoft

Build date: 5/2/2013

© 2013 Microsoft. All rights reserved.