struktur WNODE_SINGLE_INSTANCE (wmistr.h)

  • Artikel

Struktur WNODE_SINGLE_INSTANCE berisi nilai untuk semua item data dalam satu contoh blok data.

Sintaks

typedef struct tagWNODE_SINGLE_INSTANCE {
  struct _WNODE_HEADER WnodeHeader;
  ULONG                OffsetInstanceName;
  ULONG                InstanceIndex;
  ULONG                DataBlockOffset;
  ULONG                SizeDataBlock;
  UCHAR                VariableData[];
} WNODE_SINGLE_INSTANCE, *PWNODE_SINGLE_INSTANCE;

Anggota

WnodeHeader

Adalah 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.

OffsetInstanceName

Menunjukkan offset dari awal struktur ini ke nama instans dinamis instans ini, diselaraskan pada batas USHORT. Anggota ini hanya valid jika WNODE_FLAG_STATIC_INSTANCE_NAMES jelas di WnodeHeader.Flags. Jika blok data terdaftar dengan nama instans statis, WMI mengabaikan OffsetInstanceName.

InstanceIndex

Menunjukkan indeks instans yang terdaftar dengan nama instans statis. Anggota ini hanya valid jika WNODE_FLAG_STATIC_INSTANCE_NAMES diatur dalam WnodeHeader.Flags. Jika blok data terdaftar dengan nama instans dinamis, WMI mengabaikan InstanceIndex.

DataBlockOffset

Menunjukkan offset dari awal struktur ini hingga awal instans.

SizeDataBlock

Menunjukkan ukuran blok data untuk instans ini.

VariableData

Berisi data tambahan, termasuk nama instans dinamis jika ada, padding sehingga instans dimulai pada batas 8-byte, dan instans blok data yang akan dikembalikan.

Keterangan

WMI meneruskan WNODE_SINGLE_INSTANCE dengan permintaan IRP_MN_CHANGE_SINGLE_INSTANCE untuk mengatur item data baca/tulis dalam instans blok data. Driver dapat mengabaikan nilai yang diteruskan untuk item data baca-saja dalam instans.

Driver mengisi WNODE_SINGLE_INSTANCE sebagai respons terhadap permintaan IRP_MN_QUERY_SINGLE_INSTANCE atau untuk menghasilkan peristiwa yang terdiri dari satu instans.

Persyaratan

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

Lihat juga

WNODE_EVENT_ITEM

WNODE_HEADER