EVT_WDF_WMI_INSTANCE_SET_INSTANCE fungsi panggilan balik (wdfwmi.h)

Artikel
08/08/2023

[Berlaku untuk KMDF saja]

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.

Mengembalikan nilai

Fungsi panggilan balik EvtWmiInstanceSetInstance harus mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, fungsi ini harus mengembalikan nilai status yang NT_SUCCESS(statusnya) sama dengan FALSE. Jika buffer input yang dirujuk 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 lainnya dari driver. Jika data fungsi panggilan balik EvtWmiInstanceSetInstance bersifat dinamis dan dibagikan dengan fungsi panggilan balik lainnya, driver Anda dapat menggunakan kunci tunggu kerangka kerja atau kunci putar untuk menyinkronkan akses ke data.

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