struktur WNODE_EVENT_REFERENCE (wmistr.h)

Struktur WNODE_EVENT_REFERENCE berisi informasi yang dapat digunakan WMI untuk mengkueri peristiwa yang melebihi batas ukuran peristiwa yang ditetapkan dalam registri.

Sintaks

typedef struct tagWNODE_EVENT_REFERENCE {
  struct _WNODE_HEADER WnodeHeader;
  GUID                 TargetGuid;
  ULONG                TargetDataBlockSize;
  union {
    ULONG TargetInstanceIndex;
    WCHAR TargetInstanceName[];
  } DUMMYUNIONNAME;
} WNODE_EVENT_REFERENCE, *PWNODE_EVENT_REFERENCE;

Anggota

WnodeHeader

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

TargetGuid

Menunjukkan GUID yang mewakili peristiwa untuk dikueri.

TargetDataBlockSize

Menunjukkan ukuran peristiwa.

DUMMYUNIONNAME

DUMMYUNIONNAME.TargetInstanceIndex

Menunjukkan indeks ke dalam daftar driver nama instans statis untuk peristiwa tersebut. Anggota ini hanya valid jika blok peristiwa terdaftar dengan nama instans statis dan WNODE_FLAGS_STATIC_INSTANCE_NAMES diatur dalam WnodeHeader.Flags.

DUMMYUNIONNAME.TargetInstanceName

Menunjukkan nama instans dinamis peristiwa sebagai string Unicode yang dihitung. Anggota ini hanya valid jika WNODE_FLAGS_STATIC_INSTANCE_NAMES jelas di WnodeHeader.Flags dan blok peristiwa terdaftar dengan nama instans dinamis.

Keterangan

Jika jumlah data untuk suatu peristiwa melebihi ukuran maksimum yang ditetapkan dalam registri, driver dapat menghasilkan WNODE_EVENT_REFERENCE yang menentukan WNODE_EVENT_ITEM yang dapat dikueri WMI untuk mendapatkan peristiwa tersebut. Untuk informasi selengkapnya tentang menentukan dan menghasilkan peristiwa WMI, lihat Menerapkan WMI.

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

Persyaratan

Persyaratan	Nilai
Header	wmistr.h (termasuk Wmistr.h)

Lihat juga

IoWMIDeviceObjectToProviderId

WNODE_EVENT_ITEM

WNODE_HEADER