WMIREGINFOW-Struktur (wmistr.h)

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;

Angehörige

BufferSize

Gibt die Gesamtgröße der WMI-Registrierungsdaten an, die dieser WMIREGINFO- Struktur zugeordnet sind, berechnet wie folgt: (Größe der(WMIREGINFO) + (GuidCount * Sizeof(WMIREGGUID) + zusätzlichen Daten). Weitere Daten können Elemente wie den MOF-Ressourcennamen, den Registrierungspfad und statische Instanznamen für Blöcke enthalten.

NextWmiRegInfo

Wenn ein Treiber WMI-Anforderungen im Namen eines anderen Treibers verarbeitet, kann ein Klassentreiber im Namen eines Miniklassentreibers NextWmiRegInfo den Offset in Byte vom Anfang dieses WMIREGINFO zur nächsten WMIREGINFO- Struktur angeben, die WMI-Registrierungsinformationen für den anderen Treiber enthält. Andernfalls ist NextWmiRegInfo null.

RegistryPath

Gibt den Offset in Bytes vom Anfang dieser Struktur auf eine gezählte 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. Dieses Mitglied sollte nur als Reaktion auf eine WMI-Registrierungsanforderung festgelegt werden (IRP_MN_REGINFO oder IRP_MN_REGINFO_EX mit Parameters.WMI.DataPath auf WMIREGISTER festgelegt).

MofResourceName

Gibt den Offset in Bytes vom Anfang dieser Struktur auf eine gezählte Unicode-Zeichenfolge an, die den Namen der MOF-Ressource in der Bilddatei des Treibers angibt. Die Zeichenfolge muss an einer USHORT-Grenze ausgerichtet werden. Dieses Mitglied sollte nur als Reaktion auf eine WMI-Registrierungsanforderung festgelegt werden (IRP_MN_REGINFO oder IRP_MN_REGINFO_EX mit Parameters.WMI.DataPath auf WMIREGISTER festgelegt).

GuidCount

Gibt die Anzahl der WMIREGGUID- Strukturen im Array bei WmiRegGuidan.

WmiRegGuid

Ist ein Array von GuidCount WMIREGGUID Strukturen.

Bemerkungen

Als Reaktion auf eine Registrierungsanforderung (IRP_MN_REGINFO oder IRP_MN_REGINFO_EX mit Parameters.WMI.DataPath auf WMIREGISTER festgelegt) erstellt ein Treiber mindestens eine WMIREGINFO Struktur und schreibt die WMIREGINFO Struktur in den Puffer bei IrpStack->Parameters.WMI.Buffer. Die WMIREGINFO--Struktur enthält ein Array WMIREGGUID- Strukturen, eines 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 ein weiteres WMIREGINFO- mit einem Array von WMIREGGUID- Strukturen für jeden vom anderen Treiber verfügbar gemachten Block, legt den NextWmiRegInfo- Member des ersten WMIREGINFO- auf einen Offset in Bytes vom Anfang des ersten WMIREGINFO am Anfang der nächsten WMIREGINFO- im Puffer fest. und schreibt beide Strukturen in den Puffer. Der Treiber gibt die Gesamtgröße von WMIREGINFO Strukturen und zugeordneten Daten an, wenn IoCompleteRequest- aufgerufen wird, um das IRP abzuschließen.

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

Anforderungen

Siehe auch

IRP_MN_REGINFO

IRP_MN_REGINFO_EX

IoCompleteRequest-

WMIREGGUID-