EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL fungsi panggilan balik (wdfwmi.h)

Artikel
08/08/2023

[Hanya berlaku untuk KMDF]

Fungsi panggilan balik EvtWmiProviderFunctionControl driver memungkinkan dan menonaktifkan dukungan driver untuk mengumpulkan data dan mengirim peristiwa untuk penyedia data WMI tertentu.

Sintaks

EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL EvtWdfWmiProviderFunctionControl;

NTSTATUS EvtWdfWmiProviderFunctionControl(
  [in] WDFWMIPROVIDER WmiProvider,
  [in] WDF_WMI_PROVIDER_CONTROL Control,
  [in] BOOLEAN Enable
)
{...}

Parameter

[in] WmiProvider

Handel ke objek penyedia WMI.

[in] Control

Nilai WDF_WMI_PROVIDER_CONTROL-typed yang mengidentifikasi kemampuan yang harus diaktifkan atau dinonaktifkan oleh driver.

[in] Enable

Nilai Boolean yang, jika TRUE, menunjukkan bahwa driver harus mengaktifkan kemampuan yang ditentukan Kontrol . Jika FALSE, driver harus menonaktifkan kemampuan.

Nilai kembali

Fungsi panggilan balik EvtWmiProviderFunctionControl harus mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, itu harus mengembalikan nilai status yang NT_SUCCESS(status) sama dengan FALSE.

Keterangan

Untuk mendaftarkan fungsi panggilan balik EvtWmiProviderFunctionControl , driver Anda harus menempatkan alamat fungsi dalam struktur WDF_WMI_PROVIDER_CONFIG sebelum memanggil WdfWmiProviderCreate.

Jika driver Anda menetapkan bendera WdfWmiProviderExpensive di anggota Bendera struktur WDF_WMI_PROVIDER_CONFIG penyedia data WMI, dan jika driver menyediakan fungsi panggilan balik EvtWmiProviderFunctionControl , kerangka kerja memanggil fungsi panggilan balik ketika driver harus mengaktifkan atau menonaktifkan kemampuannya untuk mengumpulkan data WMI.

Alih-alih menyediakan fungsi panggilan balik EvtWmiProviderFunctionControl , driver dapat memanggil WdfWmiProviderIsEnabled untuk mengetahui apakah itu harus mengaktifkan atau menonaktifkan pengumpulan data.

Untuk informasi selengkapnya tentang fungsi panggilan balik EvtWmiProviderFunctionControl , lihat Mendukung WMI di driver Framework-Based.