WdfRequestSetActivityId 関数 (wdfrequest.h)

[UMDF にのみ適用]

WdfRequestSetActivityId メソッドは、アクティビティ識別子を I/O 要求に関連付けます。

構文

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

[in] Request

フレームワーク要求オブジェクトへのハンドル。

[in] ActivityId

I/O 要求に格納するアクティビティ識別子 GUID へのポインター。

なし

WdfRequestSetActivityId を呼び出しても、以前に存在していたアクティビティ識別子との関連付けは設定されません。ドライバーが WdfRequestSetActivityId を呼び出すと、既存のアクティビティ識別子が上書きされます。

関連付けを設定するには、 WdfRequestRetrieveActivityId を呼び出して既存の識別子を取得し、 EventWriteTransfer を呼び出して既存の識別子を新しい識別子に関連付けます。

ドライバーが WdfRequestReuse を呼び出すとき、フレームワークは要求のアクティビティ識別子をクリアしません。

アクティビティ識別子の詳細については、「アクティビティ識別子の使用」を参照してください。