Fungsi IoWMIWriteEvent (wdm.h)

  • Artikel

Rutinitas IoWMIWriteEvent memberikan peristiwa tertentu ke komponen WMI mode pengguna untuk pemberitahuan.

Sintaks

NTSTATUS IoWMIWriteEvent(
  [in, out] PVOID WnodeEventItem
);

Parameter

[in, out] WnodeEventItem

Arahkan ke struktur WNODE_EVENT_ITEM untuk dikirimkan ke komponen WMI mode pengguna yang meminta pemberitahuan peristiwa.

Nilai kembali

IoWMIWriteEvent mengembalikan kode status dari daftar berikut:

Menampilkan kode Deskripsi
STATUS_SUCCESS
 Menunjukkan bahwa WMI telah berhasil mengantrekan peristiwa untuk pengiriman ke komponen WMI mode pengguna.
STATUS_UNSUCCESSFUL
 Menunjukkan bahwa layanan WMI tidak tersedia.
STATUS_BUFFER_OVERFLOW
 Menunjukkan bahwa item peristiwa yang ditentukan melebihi ukuran maksimum yang diizinkan.
STATUS_INSUFFICIENT_RESOURCES
 Menunjukkan bahwa sumber daya yang tidak mencukup tersedia bagi WMI untuk mengantre peristiwa untuk pengiriman.

Keterangan

Struktur WNODE_EVENT_ITEM yang dialokasikan oleh pemanggil dan diteruskan di WnodeEventItem harus dialokasikan dari kumpulan yang tidak dipagasi. Jika IoWMIWriteEvent mengembalikan STATUS_SUCCESS, memori untuk item peristiwa akan secara otomatis dibebaskan oleh sistem. Jika IoWMIWriteEvent mengembalikan apa pun selain STATUS_SUCCESS, pemanggil bertanggung jawab untuk membebaskan buffer.

Driver hanya boleh memanggil IoWMIWriteEvent untuk peristiwa yang telah diaktifkan untuk WMI. Ini memastikan bahwa ada konsumen peristiwa yang menunggu indikasi pada peristiwa itu.

Penelepon rutin ini harus berjalan di IRQL <= APC_LEVEL, dengan satu pengecualian. Ketika anggota Bendera dari struktur WNODE_HEADER berisi WNODE_FLAG_TRACED_GUID, IoWMIWriteEvent dapat dipanggil di IRQL apa pun. (Struktur WNODE_HEADER adalah anggota struktur WNODE_EVENT_ITEM yang ditunjuk oleh parameter WnodeEventItem .)

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 2000.
Target Platform Universal
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL (lihat bagian Keterangan)

Lihat juga

IoWmiDeviceObjectToProviderId

WNODE_EVENT_ITEM