struktur WNODE_EVENT_ITEM (wmistr.h)

Artikel
02/27/2024

Struktur WNODE_EVENT_ITEM berisi data yang dihasilkan oleh driver untuk suatu peristiwa.

Sintaks

typedef struct tagWNODE_EVENT_ITEM {
  struct _WNODE_HEADER WnodeHeader;
} WNODE_EVENT_ITEM, *PWNODE_EVENT_ITEM;

Anggota

WnodeHeader

Menentukan struktur WNODE_HEADER yang berisi informasi umum untuk semua struktur WNODE_XXX , seperti ukuran buffer, GUID yang mewakili blok data yang terkait dengan permintaan, dan bendera yang memberikan informasi tentang data WNODE_XXX yang diteruskan atau dikembalikan.

Keterangan

Anggota WnodeHeader dari struktur WNODE_EVENT_ITEM diikuti oleh struktur yang jenisnya tergantung pada bendera yang diatur dalam WnodeHeader. Kemungkinannya termasuk WNODE_ALL_DATA, WNODE_SINGLE_INSTANCE, dan WNODE_SINGLE_ITEM. Untuk informasi selengkapnya tentang bendera, lihat WNODE_HEADER.

Anggota ProviderId dari struktur WNODE_HEADER untuk digunakan dalam struktur WNODE_EVENT_ITEM harus diinisialisasi menggunakan IoWMIDeviceObjectToProviderId.

Driver hanya menghasilkan peristiwa yang sebelumnya telah diaktifkan sebagai respons terhadap permintaan IRP_MN_ENABLE_EVENTS . Untuk menghasilkan peristiwa, driver memanggil IoWMIWriteEvent dan meneruskan pointer ke WNODE_EVENT_ITEM. WMI mengantrekan acara untuk pengiriman ke semua konsumen data yang terdaftar untuk peristiwa tersebut.

Untuk performa terbaik, peristiwa harus berukuran kecil. Namun, jika jumlah data untuk suatu peristiwa melebihi ukuran maksimum yang ditentukan dalam registri, driver dapat melewati WNODE_EVENT_REFERENCE, yang digunakan WMI untuk mengkueri WNODE_EVENT_ITEM terkait. Untuk informasi selengkapnya tentang menentukan dan menghasilkan peristiwa WMI, lihat Instrumentasi Manajemen Windows.