WMIREGINFOW-Struktur (wmistr.h)

Artikel
08/08/2023

Die WMIREGINFO-Struktur enthält Informationen, die von einem Treiber bereitgestellt werden, um seine Datenblöcke und Ereignisblöcke zu registrieren oder zu aktualisieren.

Syntax

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

Member

BufferSize

Gibt die Gesamtgröße der WMI-Registrierungsdaten an, die dieser WMIREGINFO-Struktur zugeordnet sind, berechnet wie folgt: (sizeof(WMIREGINFO) + (GuidCount * sizeof(WMIREGGUID) + additionaldata). Zusätzliche Daten können Elemente wie den NAMEN der MOF-Ressource, den Registrierungspfad und statische instance Namen für Blöcke enthalten.

NextWmiRegInfo

Wenn ein Treiber WMI-Anforderungen im Namen eines anderen Treibers verarbeitet, wie ein Klassentreiber möglicherweise im Namen eines Miniklassentreibers, gibt NextWmiRegInfo den Offset in Bytes vom Anfang dieser WMIREGINFO bis zur nächsten WMIREGINFO-Struktur an, die WMI-Registrierungsinformationen für den anderen Treiber enthält. Andernfalls ist NextWmiRegInfo null.

RegistryPath

Gibt den Offset in Bytes vom Anfang dieser Struktur bis zu einer gezählten Unicode-Zeichenfolge an, die den Registrierungspfad angibt, der an die DriverEntry-Routine des Treibers übergeben wird. Die Zeichenfolge muss an einer USHORT-Grenze ausgerichtet werden. Dieser Member sollte nur als Reaktion auf eine WMI-Registrierungsanforderung festgelegt werden (IRP_MN_REGINFO oder IRP_MN_REGINFO_EX , wobei Parameters.WMI.DataPath auf WMIREGISTER festgelegt ist).

MofResourceName

Gibt den Offset in Bytes vom Anfang dieser Struktur bis zu einer gezählten Unicode-Zeichenfolge an, die den Namen der MOF-Ressource in der Imagedatei des Treibers angibt. Die Zeichenfolge muss an einer USHORT-Grenze ausgerichtet werden. Dieser Member sollte nur als Reaktion auf eine WMI-Registrierungsanforderung festgelegt werden (IRP_MN_REGINFO oder IRP_MN_REGINFO_EX , wobei Parameters.WMI.DataPath auf WMIREGISTER festgelegt ist).

GuidCount

Gibt die Anzahl der WMIREGGUID-Strukturen im Array bei WmiRegGuid an.

WmiRegGuid

Ist ein Array von GuidCount WMIREGGUID-Strukturen .

Hinweise

Als Reaktion auf eine Registrierungsanforderung (IRP_MN_REGINFO oder IRP_MN_REGINFO_EX, bei der Parameters.WMI.DataPath auf WMIREGISTER festgelegt ist), erstellt ein Treiber mindestens eine WMIREGINFO-Struktur und schreibt die WMIREGINFO-Struktur in den Puffer unter IrpStack-Parameters.WMI.Buffer>. Die WMIREGINFO-Struktur enthält ein Array von WMIREGGUID-Strukturen , eine für jeden Datenblock oder Ereignisblock, der vom Treiber verfügbar gemacht wird.

Wenn der Treiber WMI-Anforderungen im Namen eines anderen Treibers verarbeitet, erstellt er eine weitere WMIREGINFO mit einem Array von WMIREGGUID-Strukturen für jeden Block, der vom anderen Treiber verfügbar gemacht wird, und legt das NextWmiRegInfo-Element des ersten WMIREGINFO auf einen Offset in Bytes vom Anfang des ersten WMIREGINFO bis zum Anfang des nächsten WMIREGINFO im Puffer fest. und schreibt beide Strukturen in den Puffer. Der Treiber gibt die Gesamtgröße der WMIREGINFO-Strukturen und der zugehörigen Daten an, wenn IoCompleteRequest aufgerufen wird, um das IRP abzuschließen.

Ein Treiber kann die gleichen WMIREGINFO-Strukturen verwenden, um Blöcke als Reaktion auf eine Updateanforderung zu entfernen oder zu aktualisieren (IRP_MN_REGINFO oder IRP_MN_REGINFO_EX , wobei Parameters.WMI.DataPath auf WMIUPDATE festgelegt ist). Wenn WMIREG_FLAG_REMOVE_GUID im Flags-Member einer WMIREGGUID festgelegt ist, entfernt WMI diesen Block aus der Liste der Blöcke, die zuvor vom Treiber registriert wurden. Wenn WMIREG_FLAG_REMOVE_GUID eindeutig ist, aktualisiert WMI die Registrierungsinformationen für diesen Block nur, wenn sich andere WMIREGGUID-Member geändert haben. Andernfalls ändert sich WMI nicht in seine Registrierungsinformationen für diesen Block.