SCSIWMIGUIDREGINFO-Struktur (scsiwmi.h)

Die SCSIWMIGUIDREGINFO-Struktur enthält Informationen zu einem bestimmten Daten- oder Ereignisblock, der von einem SCSI-Miniporttreiber unterstützt wird.

Hinweis Der SCSI-Porttreiber und die SCSI-Miniporttreibermodelle können in Zukunft geändert oder nicht mehr verfügbar sein. Stattdessen wird empfohlen, die Modelle Storport-Treiber und Storport-Miniporttreiber zu verwenden.
 

Syntax

typedef struct {
  LPCGUID Guid;
  ULONG   InstanceCount;
  ULONG   Flags;
} SCSIWMIGUIDREGINFO, *PSCSIWMIGUIDREGINFO;

Member

Guid

Zeigt auf die GUID, die den Block identifiziert.

InstanceCount

Gibt die Anzahl der für den Block definierten Instanzen an.

Flags

Gibt Die Merkmale des Blocks an. Der SCSI-Porttreiber legt alle außer den folgenden WMIREG_FLAG_XXX im Namen des Miniporttreibers fest. Ein Miniporttreiber kann mindestens eins der folgenden Flags festlegen:

WMIREG_FLAG_EVENT_ONLY_GUID

Der Block kann nur als Ereignis aktiviert oder deaktiviert werden und kann nicht abgefragt oder festgelegt werden. Wenn dieses Flag eindeutig ist, kann der Block auch abgefragt oder festgelegt werden.

WMIREG_FLAG_EXPENSIVE

Fordert den Porttreiber an, eine Aktivierungssammlungs-SRB zu senden, wenn ein Daten consumer den Datenblock zum ersten Mal öffnet, und einen Deaktivierungssammlungs-SRB, wenn der letzte Daten consumer den Datenblock schließt. Dies wird empfohlen, wenn sich das Sammeln solcher Daten auf die Leistung auswirkt. Ein Miniporttreiber muss die Daten erst erfassen, wenn ein Datenverbraucher sie explizit anfordert, indem er den Block öffnet.

WMIREG_FLAG_REMOVE_GUID

Entfernt die Unterstützung für einen zuvor registrierten Block, wenn er festgelegt ist.

Hinweise

Der Miniporttreiber übergibt einen Zeiger an einen SCSI_WMILIB_CONTEXT der ein SCSIWMIREGGUID-Array im WmiLibInfo-Parameter von ScsiPortWmiDispatchFunction enthält. Der Miniporttreiber übergibt diese Informationen jedes Mal, wenn er ScsiPortWmiDispatchFunction aufruft. Jede SCSIWMIREGGUID-Struktur im Array stellt einen der Daten- oder Ereignisblöcke des Miniporttreibers dar.

Das SCSIWMIREGGUID-Array eines Miniporttreibers sollte alle Standarddatenblöcke enthalten, die in "wmicore.mof " für den Gerätetyp definiert sind, und möglicherweise vom Miniporttreiber definierte Daten- und Ereignisblöcke enthalten. Ein Miniporttreiber definiert benutzerdefinierte Daten- und Ereignisblöcke in einer MOF-Datei, die als Ressource kompiliert wird, die an das binäre Image des Miniporttreibers angefügt und im MofResourceName-Parameter der HwScsiWmiQueryReginfo-Routine des Miniporttreibers angegeben wird.

Weitere Informationen zum Definieren von Blöcken finden Sie unter Windows-Verwaltungsinstrumentation.

Anforderungen

Anforderung Wert
Header scsiwmi.h (schließen Sie Scsiwmi.h ein)

Weitere Informationen

HwScsiWmiQueryReginfo

SCSI_WMILIB_CONTEXT

ScsiPortWmiDispatchFunction