Metode IWDFIoRequest3::RetrieveActivityId (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 RetrieveActivityId mengambil pengidentifikasi aktivitas saat ini yang terkait dengan permintaan I/O.
Sintaks
HRESULT RetrieveActivityId(
[out] LPGUID ActivityId
);
Parameter
[out] ActivityId
Penunjuk ke lokasi untuk menyimpan GUID yang diambil.
Nilai kembali
RetrieveActivityId mengembalikan S_OK jika panggilan berhasil. Jika tidak, metode ini mungkin mengembalikan salah satu nilai berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Tidak ada ID aktivitas yang terkait dengan permintaan. |
Keterangan
Permintaan yang tercermin dari mode kernel memiliki pengidentifikasi aktivitas yang tersedia hanya jika penyedia Pelacakan Kernel diaktifkan atau jika driver UMDF yang disebut IWDFIoRequest3::SetActivityId setelah menerima permintaan. Untuk informasi selengkapnya tentang Pelacakan Peristiwa untuk Windows (ETW), lihat Pelacakan Peristiwa.
Permintaan yang dimulai oleh driver UMDF memiliki pengidentifikasi aktivitas yang tersedia hanya jika driver UMDF sebelumnya disebut IWDFIoRequest3::SetActivityId.
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 WdfRequestRetrieveActivityId.
Contoh
Contoh kode berikut menunjukkan driver dapat mengambil pengidentifikasi aktivitas dari satu permintaan lalu menggunakannya untuk mengatur pengidentifikasi aktivitas untuk permintaan lain.
hrQI = pWdfRequest->QueryInterface(IID_PPV_ARGS(&pOriginalRequest3));
ASSERT(SUCCEEDED(hrQI));
hrQI = pNewRequest->QueryInterface(IID_PPV_ARGS(&pNewRequest3));
ASSERT(SUCCEEDED(hrQI));
//
// Obtain activity id from original request and set in the new one
//
pOriginalRequest3->RetrieveActivityId(&activityId);
pNewRequest3->SetActivityId(&activityId);
pOriginalRequest3->Release();
pNewRequest3->Release();
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk