Hardware Dev Center

Collapse the table of content
Expand the table of content
Espandi Riduci a icona

WdfRequestRetrieveActivityId method

[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

Request [in]

A handle to a framework request object.

ActivityId [out]

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 codeDescription
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

Target platform

Universal

Minimum support

Windows 8.1

Minimum UMDF version

2.0

Header

Wdfrequest.h (include Wdf.h)

Library

WUDFx02000.lib

DLL

WUDFx02000.dll

IRQL

PASSIVE_LEVEL

See also

WdfRequestSetActivityId

 

 

Send comments about this topic to Microsoft

Mostra:
© 2015 Microsoft