WdfRequestRetrieveActivityId 関数 (wdfrequest.h)
[UMDF にのみ適用]
WdfRequestRetrieveActivityId メソッドは、I/O 要求に関連付けられている現在のアクティビティ識別子を取得します。
構文
NTSTATUS WdfRequestRetrieveActivityId(
[in] WDFREQUEST Request,
[out] LPGUID ActivityId
);
パラメーター
[in] Request
フレームワーク要求オブジェクトへのハンドル。
[out] ActivityId
取得した GUID を格納する場所へのポインター。
戻り値
操作が成功した場合、WdfRequestRetrieveActivityId はSTATUS_SUCCESSを返します。 その他の戻り値は次のとおりです。
リターン コード | 形容 |
---|---|
|
要求に関連付けられているアクティビティ 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 |