struttura WNODE_SINGLE_ITEM (wmistr.h)

  • Articolo

La struttura WNODE_SINGLE_ITEM contiene il valore di un singolo elemento di dati in un'istanza di un blocco di dati.

Sintassi

typedef struct tagWNODE_SINGLE_ITEM {
  struct _WNODE_HEADER WnodeHeader;
  ULONG                OffsetInstanceName;
  ULONG                InstanceIndex;
  ULONG                ItemId;
  ULONG                DataBlockOffset;
  ULONG                SizeDataItem;
  UCHAR                VariableData[];
} WNODE_SINGLE_ITEM, *PWNODE_SINGLE_ITEM;

Members

WnodeHeader

Struttura WNODE_HEADER che contiene informazioni comuni a tutte le strutture WNODE_XXX , ad esempio le dimensioni del buffer, il GUID che rappresenta un blocco di dati associato a una richiesta e flag che forniscono informazioni sui dati WNODE_XXX passati o restituiti.

OffsetInstanceName

Indica l'offset dall'inizio di questa struttura al nome dell'istanza dinamica, se presente, allineato su un limite USHORT. Questo membro è valido solo se WNODE_FLAG_STATIC_INSTANCE_NAMES è deselezionato in WnodeHeader.Flags. Se il blocco di dati è stato registrato con nomi di istanza statici, WMI ignora OffsetInstanceName.

InstanceIndex

Indica l'indice nell'elenco dei nomi di istanza statici di questa istanza del driver. Questo membro è valido solo se il blocco di dati è stato registrato con nomi di istanza statici e WNODE_FLAG_STATIC_INSTANCE_NAMES è impostato in WnodeHeader.Flags. Se il blocco di dati è stato registrato con nomi di istanze dinamiche, WMI ignora InstanceIndex.

ItemId

Specifica l'ID dell'elemento di dati da impostare.

DataBlockOffset

Indica l'offset dall'inizio di questa struttura al nuovo valore per l'elemento di dati.

SizeDataItem

Indica le dimensioni dell'elemento di dati.

VariableData

Contiene dati aggiuntivi, incluso il nome dell'istanza dinamica, se presente, la spaziatura interna in modo che il valore dei dati inizi su un limite di 8 byte e il nuovo valore per l'elemento di dati.

Commenti

WMI passa un WNODE_SINGLE_ITEM con una richiesta di IRP_MN_CHANGE_SINGLE_ITEM per impostare il valore di un elemento di dati in un'istanza di un blocco di dati.

Un driver compila un WNODE_SINGLE_ITEM per generare un evento costituito da un singolo elemento dati.

Requisiti

Requisito Valore
Intestazione wmistr.h (include Wmistr.h)

Vedi anche

WNODE_EVENT_ITEM

WNODE_HEADER