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.

Sintaksis

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 InBuffer menunjuk.

[in] InBuffer

Penunjuk ke buffer input.

Mengembalikan nilai

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 ditunjukkan parameter InBuffer terlalu kecil untuk berisi semua data yang diharapkan driver, fungsi panggilan balik harus mengembalikan STATUS_WMI_SET_FAILURE.

Komentar

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 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 EvtWmiInstanceSetItem, lihat Mendukung WMI di driver Framework-Based.

Persyaratan

Syarat	Nilai
Platform Target	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