Struttura WMIREGINFOW (wmistr.h)

Articolo
02/27/2024

La struttura WMIREGINFO contiene informazioni fornite da un driver per registrare o aggiornare i blocchi dati e i blocchi eventi.

Sintassi

typedef struct {
  ULONG       BufferSize;
  ULONG       NextWmiRegInfo;
  ULONG       RegistryPath;
  ULONG       MofResourceName;
  ULONG       GuidCount;
  WMIREGGUIDW WmiRegGuid[];
} WMIREGINFOW, *PWMIREGINFOW;

Members

BufferSize

Indica la dimensione totale dei dati di registrazione WMI associati a questa struttura WMIREGINFO, calcolata come segue: (sizeof(WMIREGINFO) + (GuidCount * sizeof(WMIREGGUID) + additionaldata). I dati aggiuntivi possono includere elementi come il nome della risorsa MOF, il percorso del Registro di sistema e i nomi di istanza statici per i blocchi.

NextWmiRegInfo

Se un driver gestisce le richieste WMI per conto di un altro driver, come driver di classe potrebbe per conto di un driver miniclasse, NextWmiRegInfo indica l'offset in byte dall'inizio di questa struttura WMIREGINFO alla struttura WMIREGINFO successiva che contiene informazioni di registrazione WMI per l'altro driver. In caso contrario, NextWmiRegInfo è zero.

RegistryPath

Indica l'offset in byte dall'inizio di questa struttura a una stringa Unicode conteggiata che specifica il percorso del Registro di sistema passato alla routine DriverEntry del driver. La stringa deve essere allineata su un limite USHORT. Questo membro deve essere impostato solo in risposta a una richiesta di registrazione WMI (IRP_MN_REGINFO o IRP_MN_REGINFO_EX con Parameters.WMI.DataPath impostata su WMIREGISTER).

MofResourceName

Indica l'offset in byte dall'inizio di questa struttura a una stringa Unicode conteggiata che specifica il nome della risorsa MOF nel file di immagine del driver. La stringa deve essere allineata su un limite USHORT. Questo membro deve essere impostato solo in risposta a una richiesta di registrazione WMI (IRP_MN_REGINFO o IRP_MN_REGINFO_EX con Parameters.WMI.DataPath impostata su WMIREGISTER).

GuidCount

Indica il numero di strutture WMIREGGUID nella matrice in WmiRegGuid.

WmiRegGuid

Matrice di strutture WMIREGGUIDguidCount.

Commenti

In risposta a una richiesta di registrazione (IRP_MN_REGINFO o IRP_MN_REGINFO_EX con Parameters.WMI.DataPath impostata su WMIREGISTER), un driver compila almeno una struttura WMIREGINFO e scrive la struttura WMIREGINFO nel buffer in IrpStack-Parameters.WMI.Buffer>. La struttura WMIREGINFO contiene una matrice di strutture WMIREGGUID , una per ogni blocco di dati o blocco eventi esposto dal driver.

Se il driver gestisce le richieste WMI per conto di un altro driver, compila un'altra WMIREGINFO contenente una matrice di strutture WMIREGGUID per ogni blocco esposto dall'altro driver, imposta il membro NextWmiRegInfodel primo WMIREGINFO su un offset in byte dall'inizio del primo WMIREGINFO all'inizio del successivo WMIREGINFO nel buffer, e scrive entrambe le strutture nel buffer. Il driver indica la dimensione totale delle strutture WMIREGINFO e dei dati associati quando chiama IoCompleteRequest per completare l'IRP .

Un driver può usare la stessa struttura WMIREGINFO per rimuovere o aggiornare i blocchi in risposta a una richiesta di aggiornamento (IRP_MN_REGINFO o IRP_MN_REGINFO_EX con Parameters.WMI.DataPath impostata su WMIUPDATE ). Se WMIREG_FLAG_REMOVE_GUID è impostato nel membro Flag di un WMIREGGUID, WMI rimuove tale blocco dall'elenco di blocchi registrati in precedenza dal driver. Se WMIREG_FLAG_REMOVE_GUID è chiaro, WMI aggiorna le informazioni di registrazione per tale blocco solo se altri membri WMIREGGUID sono stati modificati. In caso contrario, WMI non cambia le informazioni di registrazione per tale blocco.

Requisiti

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

Vedi anche