Fungsi WdfWmiProviderGetTracingHandle (wdfwmi.h)

  • Artikel

[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)

Lihat juga

WDF_WMI_PROVIDER_CONFIG

WdfWmiInstanceGetProvider

WdfWmiProviderCreate