WdfRequestSetActivityId function (wdfrequest.h)

[Applies to UMDF only]

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

Syntax

void WdfRequestSetActivityId(
  [in] WDFREQUEST Request,
  [in] LPGUID     ActivityId
);

Parameters

[in] Request

A handle to a framework request object.

[in] ActivityId

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

Return value

None

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

Requirement Value
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