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

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

要件

要件 値
サポートされている最小のクライアント Windows 8.1
対象プラットフォーム ユニバーサル
最小 UMDF バージョン 2.0
Header wdfrequest.h (Wdf.h を含む)
Library WUDFx02000.lib
[DLL] WUDFx02000.dll
IRQL PASSIVE_LEVEL

こちらもご覧ください

WdfRequestRetrieveActivityId