次の方法で共有


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
ヘッダー wdfrequest.h (Wdf.h を含む)
ライブラリ WUDFx02000.lib
DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

関連項目

WdfRequestSetActivityId