EVT_WDF_WMI_INSTANCE_SET_ITEM fungsi panggilan balik (wdfwmi.h)

[Hanya berlaku untuk KMDF]

Fungsi panggilan balik EvtWmiInstanceSetItem driver menetapkan satu item data instans penyedia data WMI ke nilai yang disediakan klien WMI.

Sintaks

EVT_WDF_WMI_INSTANCE_SET_ITEM EvtWdfWmiInstanceSetItem;

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

Parameter

[in] WmiInstance

Handel ke objek instans WMI.

[in] DataItemId

Nilai yang mengidentifikasi item data untuk instans penyedia. Nilai ini sesuai dengan nilai WmiDataId yang ditentukan dalam file MOF penyedia.

[in] InBufferSize

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

[in] InBuffer

Penunjuk ke buffer input.

Nilai kembali

Fungsi panggilan balik EvtWmiInstanceSetItem 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 EvtWmiInstanceSetItem , 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 EvtWmiInstanceSetItem bersifat dinamis dan dibagikan dengan fungsi panggilan balik lainnya, driver Anda dapat menggunakan kunci tunggu kerangka kerja atau kunci spin untuk menyinkronkan akses ke data.

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

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Header wdfwmi.h (termasuk Wdf.h)
IRQL PASSIVE_LEVEL

Lihat juga

EvtWmiInstanceExecuteMethod

EvtWmiInstanceQueryInstance

EvtWmiInstanceSetInstance

EvtWmiProviderFunctionControl

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceBuat