Développer Réduire

WdfRequestSetActivityId method

[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

Request [in]

A handle to a framework request object.

ActivityId [in]

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

WdfRequestRetrieveActivityId

 

 

Send comments about this topic to Microsoft

Afficher:
© 2014 Microsoft