IWDFIoRequest3::SetActivityId メソッド (wudfddi.h)
[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、Windows 10 の新しいバージョンでは UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは、UMDF 2 を使用する必要があります。 詳細については、「UMDFの概要」を参照してください。
SetActivityId メソッドは、アクティビティ識別子を I/O 要求に関連付けます。
構文
void SetActivityId(
[in] LPGUID ActivityId
);
パラメーター
[in] ActivityId
I/O 要求に格納するアクティビティ識別子 GUID へのポインター。
戻り値
何一つ
備考
SetActivityId 呼び出しても、以前に存在していたアクティビティ識別子との関連付けは設定されません。 ドライバーが SetActivityId 呼び出すと、既存のアクティビティ識別子が上書きされます。
関連付けを設定するには、RetrieveActivityId を呼び出して既存の識別子を取得し、EventWriteTransfer 呼び出して既存の識別子を新しい識別子に関連付けます。
ドライバーが IWdfIoRequest2::Reuse 呼び出すとき、フレームワークは要求のアクティビティ識別子をクリアしません。
アクティビティ識別子の詳細については、「アクティビティ識別子の使用」を参照してください。
このメソッドに相当する UMDF 2 は、WdfRequestSetActivityId です。
例
SetActivityId 使用するコード例については、「RetrieveActivityId 参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 8 |
| サポート終了 | UMDF 2.0 以降では使用できません。 |
| ターゲット プラットフォーム の | デスクトップ |
| UMDF の最小バージョン を する | 1.11 |
| ヘッダー | wudfddi.h (Wudfddi.h を含む) |
| DLL | WUDFx.dll |
関連項目
IWDFIoRequest3 の