SCSI_WMILIB_CONTEXT-Struktur (scsiwmi.h)

Artikel
08/07/2023

Eine SCSI_WMILIB_CONTEXT-Struktur stellt Registrierungsinformationen für die Daten- und Ereignisblöcke eines Miniporttreibers bereit und definiert Einstiegspunkte für die HwScsiWmi Xxx-Rückrufroutinen des Miniporttreibers.

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

Syntax

typedef struct _SCSIWMILIB_CONTEXT {
  ULONG                     GuidCount;
  PSCSIWMIGUIDREGINFO       GuidList;
  PSCSIWMI_QUERY_REGINFO    QueryWmiRegInfo;
  PSCSIWMI_QUERY_DATABLOCK  QueryWmiDataBlock;
  PSCSIWMI_SET_DATABLOCK    SetWmiDataBlock;
  PSCSIWMI_SET_DATAITEM     SetWmiDataItem;
  PSCSIWMI_EXECUTE_METHOD   ExecuteWmiMethod;
  PSCSIWMI_FUNCTION_CONTROL WmiFunctionControl;
} SCSI_WMILIB_CONTEXT, *PSCSI_WMILIB_CONTEXT;

Member

GuidCount

Gibt die Anzahl der Strukturen im SCSIWMIGUIDREGINFO-Array unter GuidList an.

GuidList

Verweist auf ein Array von GuidCount SCSIWMIGUIDREGINFO-Strukturen, die Registrierungsinformationen für jeden Block enthalten.

QueryWmiRegInfo

Verweist auf die HwScsiWmiQueryReginfo-Routine des Treibers, die ein erforderlicher Einstiegspunkt für Miniporttreiber ist, die WMI unterstützen.

QueryWmiDataBlock

Verweist auf die HwScsiWmiQueryDataBlock-Routine des Treibers, die ein erforderlicher Einstiegspunkt für Miniporttreiber ist, die WMI unterstützen.

SetWmiDataBlock

Verweist auf die HwScsiWmiSetDataBlock-Routine des Treibers, die ein optionaler Einstiegspunkt für Miniporttreiber ist, die WMI unterstützen. Wenn der Miniporttreiber diese Routine nicht implementiert, muss er diesen Member auf NULL festlegen.

SetWmiDataItem

Verweist auf die HwScsiWmiSetDataItem-Routine des Treibers, die ein optionaler Einstiegspunkt für Miniporttreiber ist, die WMI unterstützen. Wenn der Miniporttreiber diese Routine nicht implementiert, muss er diesen Member auf NULL festlegen.

ExecuteWmiMethod

Verweist auf die HwScsiWmiExecuteMethod-Routine des Treibers, die ein optionaler Einstiegspunkt für Miniporttreiber ist, die WMI unterstützen. Wenn der Miniporttreiber diese Routine nicht implementiert, muss er diesen Member auf NULL festlegen.

WmiFunctionControl

Verweist auf die HwScsiWmiFunctionControl-Routine des Treibers, die ein optionaler Einstiegspunkt für Miniporttreiber ist, die WMI unterstützen. Wenn der Miniporttreiber diese Routine nicht implementiert, muss er diesen Member auf NULL festlegen.

Hinweise

Ein SCSI-Miniporttreiber, der WMI unterstützt, speichert eine initialisierte SCSI_WMILIB_CONTEXT-Struktur (oder einen Zeiger auf eine solche Struktur) in seiner Geräteerweiterung. Ein Miniporttreiber kann dieselbe SCSI_WMILIB_CONTEXT-Struktur für mehrere Geräteobjekte verwenden, wenn jedes Geräteobjekt denselben Satz von Datenblöcken bereitstellt.

Wenn der Miniporttreiber einen SRB empfängt, in dem der Function-Member auf SRB_FUNCTION_WMI festgelegt ist, ruft er ScsiPortWmiDispatchFunction mit Anforderungsparametern auf, einschließlich eines Zeigers auf eine initialisierte SCSI_WMILIB_CONTEXT-Struktur. ScsiPortWmiDispatchFunction verarbeitet die Anforderung, indem die entsprechende HwScsiWmiXxx-Routine des Miniporttreibers aufgerufen wird.

Wenn der Miniporttreiber keine optionale HwScsiWmiXxx-Routine implementiert, gibt der Porttreiber eine entsprechende status an den Aufrufer zurück.