Metode IWDFIoRequest3::SetActivityId (wudfddi.h)
[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]
Metode SetActivityId mengaitkan pengidentifikasi aktivitas dengan permintaan I/O.
Sintaks
void SetActivityId(
[in] LPGUID ActivityId
);
Parameter
[in] ActivityId
Pointer ke GUID pengidentifikasi aktivitas untuk disimpan dalam permintaan I/O.
Nilai kembali
Tidak ada
Keterangan
Memanggil SetActivityId tidak mengatur asosiasi dengan pengidentifikasi aktivitas yang ada sebelumnya. Ketika driver memanggil SetActivityId, pengidentifikasi aktivitas yang ada ditimpa.
Untuk mengatur asosiasi, ambil pengidentifikasi yang ada dengan memanggil RetrieveActivityId lalu kaitkan pengidentifikasi yang ada dengan yang baru dengan memanggil EventWriteTransfer.
Kerangka kerja tidak menghapus pengidentifikasi aktivitas permintaan saat driver memanggil IWdfIoRequest2::Reuse.
Untuk informasi selengkapnya tentang pengidentifikasi aktivitas, lihat Menggunakan Pengidentifikasi Aktivitas.
UMDF 2 yang setara dengan metode ini adalah WdfRequestSetActivityId.
Contoh
Untuk contoh kode yang menggunakan SetActivityId, lihat RetrieveActivityId.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 8 |
| Akhir dukungan | Tidak tersedia di UMDF 2.0 dan yang lebih baru. |
| Target Platform | Desktop |
| Versi UMDF minimum | 1.11 |
| Header | wudfddi.h (termasuk Wudfddi.h) |
| DLL | WUDFx.dll |