WdfRequestRetrieveActivityId 関数 (wdfrequest.h)

  • [アーティクル]

[UMDF にのみ適用]

WdfRequestRetrieveActivityId メソッドは、I/O 要求に関連付けられている現在のアクティビティ識別子を取得します。

構文

NTSTATUS WdfRequestRetrieveActivityId(
  [in]  WDFREQUEST Request,
  [out] LPGUID     ActivityId
);

パラメーター

[in] Request

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

[out] ActivityId

取得した GUID を格納する場所へのポインター。

戻り値

操作が成功した場合、 WdfRequestRetrieveActivityId は STATUS_SUCCESSを返します。 その他の戻り値は次のとおりです。

リターン コード 説明
STATUS_NOT_FOUND
 要求に関連付けられているアクティビティ ID はありません。
 

メソッドは、他の NTSTATUS 値を返す場合があります。

注釈

カーネル モードから反映された要求には、カーネル トレース プロバイダーが有効になっている場合、または要求を受信した後 に WdfRequestSetActivityId という UMDF ドライバーが呼び出された場合にのみ、アクティビティ識別子を使用できます。 Windows イベント トレース (ETW) の詳細については、「 イベント トレース」を参照してください。

UMDF ドライバーによって開始された要求には、以前 に WdfRequestSetActivityId と呼ばれた UMDF ドライバーの場合にのみ使用できるアクティビティ識別子があります。

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

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

要件

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

こちらもご覧ください

WdfRequestSetActivityId