Edit

Share via

WdfRequestRetrieveActivityId function (wdfrequest.h)

  • Article

[Applies to UMDF only]

The WdfRequestRetrieveActivityId method retrieves the current activity identifier associated with an I/O request.

Syntax

NTSTATUS WdfRequestRetrieveActivityId(
  [in]  WDFREQUEST Request,
  [out] LPGUID     ActivityId
);

Parameters

[in] Request

A handle to a framework request object.

[out] ActivityId

A pointer to a location to store the retrieved GUID.

Return value

If the operation succeeds, WdfRequestRetrieveActivityId returns STATUS_SUCCESS. Additional return values include:

Return code Description
STATUS_NOT_FOUND
 No activity ID is associated with the request.
 

The method might return other NTSTATUS values.

Remarks

Requests reflected from kernel mode have an activity identifier available only if the Kernel Trace provider is enabled or if the UMDF driver called WdfRequestSetActivityId after receiving the request. For more information about Event Tracing for Windows (ETW), see Event Tracing.

Requests initiated by the UMDF driver have an activity identifier available only if the UMDF driver previously called WdfRequestSetActivityId.

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

WdfRequestSetActivityId