WdfRequestRetrieveActivityId function (wdfrequest.h)

[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:

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

See also

WdfRequestSetActivityId