EVT_WDF_WMI_INSTANCE_SET_INSTANCE fungsi panggilan balik (wdfwmi.h)

Artikel
02/27/2024

[Hanya berlaku untuk KMDF]

Fungsi panggilan balik EvtWmiInstanceSetInstance driver mengatur semua data instans penyedia data WMI ke nilai yang disediakan klien WMI.

Sintaks

EVT_WDF_WMI_INSTANCE_SET_INSTANCE EvtWdfWmiInstanceSetInstance;

NTSTATUS EvtWdfWmiInstanceSetInstance(
  [in] WDFWMIINSTANCE WmiInstance,
  [in] ULONG InBufferSize,
  [in] PVOID InBuffer
)
{...}

Parameter

[in] WmiInstance

Handel ke objek instans WMI.

[in] InBufferSize

Ukuran, dalam byte, dari buffer input yang dirujuk InBuffer .

[in] InBuffer

Penunjuk ke buffer input.

Nilai kembali

Fungsi panggilan balik EvtWmiInstanceSetInstance harus mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, fungsi ini harus mengembalikan nilai status yang NT_SUCCESS(status) sama dengan FALSE. Jika buffer input yang dituju parameter InBuffer terlalu kecil untuk berisi semua data yang diharapkan driver, fungsi panggilan balik harus mengembalikan STATUS_WMI_SET_FAILURE.

Keterangan

Untuk mendaftarkan fungsi panggilan balik EvtWmiInstanceSetInstance , driver Anda harus menempatkan alamat fungsi dalam struktur WDF_WMI_INSTANCE_CONFIG sebelum memanggil WdfWmiInstanceCreate.

Kerangka kerja tidak menyinkronkan panggilan ke fungsi panggilan balik peristiwa WMI driver satu sama lain atau dengan fungsi panggilan balik peristiwa driver lainnya. Jika data fungsi panggilan balik EvtWmiInstanceSetInstance bersifat dinamis dan dibagikan dengan fungsi panggilan balik lainnya, driver Anda dapat menggunakan kunci tunggu atau kunci spin kerangka kerja untuk menyinkronkan akses ke data.

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