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

Lihat juga

IWDFIoRequest3

IWDFIoRequest3::RetrieveActivityId

WdfRequestSetActivityId