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 呼び出すときに、要求のアクティビティ識別子をクリアしません。

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

必要条件

関連項目

WdfRequestRetrieveActivityId