WdfRequestSetActivityId function

[Applies to UMDF only]

The WdfRequestSetActivityId method associates an activity identifier with an I/O request.

Syntax

void WdfRequestSetActivityId(
  WDFREQUEST Request,
  LPGUID     ActivityId
);

Parameters

Request

A handle to a framework request object.

ActivityId

A pointer to the activity identifier GUID to store in the I/O request.

Return Value

This method does not return a value.

Remarks

Calling WdfRequestSetActivityId does not set an association with any previously present activity identifier. When the driver calls WdfRequestSetActivityId, any existing activity identifier is overwritten.

To set an association, retrieve the existing identifier by calling WdfRequestRetrieveActivityId and then associate the existing identifier with the new one by calling EventWriteTransfer.

The framework does not clear a request's activity identifier when the driver calls WdfRequestReuse.

For more information about activity identifiers, see Using Activity Identifiers.

Requirements

   
Minimum supported client Windows 8.1
Target Platform Universal
Minimum UMDF version 2.0
Header wdfrequest.h (include Wdf.h)
Library WUDFx02000.lib
DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

See Also

WdfRequestRetrieveActivityId