Fungsi WdfWmiProviderGetTracingHandle (wdfwmi.h)
[Berlaku untuk KMDF saja]
Metode WdfWmiProviderGetTracingHandle mengembalikan handel ke pencatat peristiwa sesi pelacakan perangkat lunak WPP .
Sintaks
ULONGLONG WdfWmiProviderGetTracingHandle(
[in] WDFWMIPROVIDER WmiProvider
);
Parameter
[in] WmiProvider
Handel ke objek penyedia WMI yang diperoleh driver dengan memanggil WdfWmiProviderCreate atau WdfWmiInstanceGetProvider.
Nilai kembali
WdfWmiProviderGetTracingHandle mengembalikan handel ke pencatat pelacakan peristiwa.
Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.
Keterangan
Jika driver menetapkan bendera WdfWmiProviderTracing di anggota Bendera struktur WDF_WMI_PROVIDER_CONFIG objek penyedia WMI, itu dapat memanggil WdfWmiProviderGetTracingHandle untuk mendapatkan handel pelacakan setelah instans penyedia terdaftar. Driver dapat menggunakan handel pelacakan sebagai input ke rutinitas WmiTraceMessage .
Untuk informasi selengkapnya tentang metode WdfWmiProviderGetTracingHandle , lihat Mendukung Pelacakan Peristiwa WMI. Untuk informasi selengkapnya tentang WMI, lihat Mendukung WMI di driver Framework-Based.
Contoh
Contoh kode berikut mendapatkan handel ke pencatat peristiwa sesi pelacakan WPP.
ULONGLONG tracingHandle;
tracingHandle = WdfWmiProviderGetTracingHandle(wmiProvider);
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1,0 |
| Header | wdfwmi.h (termasuk Wdf.h) |
| Pustaka | Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.) |
| IRQL | <=DISPATCH_LEVEL |
| Aturan kepatuhan DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |