WNODE_METHOD_ITEM struttura (wmistr.h)

La struttura WNODE_METHOD_ITEM indica un metodo associato a un'istanza di un blocco di dati e contiene tutti i dati di input per il metodo.

Sintassi

typedef struct tagWNODE_METHOD_ITEM {
  struct _WNODE_HEADER WnodeHeader;
  ULONG                OffsetInstanceName;
  ULONG                InstanceIndex;
  ULONG                MethodId;
  ULONG                DataBlockOffset;
  ULONG                SizeDataBlock;
  UCHAR                VariableData[];
} WNODE_METHOD_ITEM, *PWNODE_METHOD_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 i flag che forniscono informazioni sui dati WNODE_XXX passati o restituiti.

OffsetInstanceName

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

InstanceIndex

Indica l'indice di questa istanza nell'elenco dei nomi di istanze statiche del driver per questo blocco di dati. 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 istanza dinamici, WMI ignora InstanceIndex.

MethodId

Specifica l'ID del metodo da eseguire.

DataBlockOffset

Indica l'offset dall'inizio di un WNODE_METHOD_ITEM di input ai dati di input per il metodo o l'offset dall'inizio di un WNODE_METHOD_ITEM di output ai dati di output dal metodo.

SizeDataBlock

Indica le dimensioni dei dati di input in un WNODE_METHOD_ITEM di input o zero se non è presente alcun input. In un output WNODE_METHOD_ITEM, SizeDataBlock indica le dimensioni dei dati di output o zero se non è presente alcun output.

VariableData

Contiene dati aggiuntivi, inclusi il nome dell'istanza dinamica se presente e l'input per o l'output del metodo allineato a un limite a 8 byte.

Commenti

WMI passa un WNODE_METHOD_ITEM con una richiesta di IRP_MN_EXECUTE_METHOD per specificare un metodo da eseguire in un'istanza di un blocco di dati, oltre a tutti i dati di input richiesti dal metodo.

Se un metodo genera l'output, un driver sovrascrive i dati di input con l'output in DataBlockOffset nel buffer in IrpStack-Parameters.WMI.Buffer> e imposta SizeDataBlock nella WNODE_METHOD_ITEM per specificare le dimensioni dei dati di output.

Requisiti

Vedi anche

WNODE_HEADER