SCSI_WMILIB_CONTEXT Struktur (scsiwmi.h)

2025-02-07

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

Hinweis Der SCSI-Porttreiber und die SCSI-Miniporttreibermodelle können in Zukunft geändert oder nicht mehr verfügbar sein. Stattdessen empfehlen wir die Verwendung des Storport-Treibers und Storport Miniport Treibermodelle.

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;

Angehörige

GuidCount

Gibt die Anzahl der Strukturen im SCSIWMIGUIDREGINFO-Array bei 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. Dies ist ein erforderlicher Einstiegspunkt für Miniporttreiber, die WMI unterstützen.

QueryWmiDataBlock

Verweist auf die HwScsiWmiQueryDataBlock Routine des Treibers, die einen erforderlichen Einstiegspunkt für Miniporttreiber darstellt, die WMI unterstützen.

SetWmiDataBlock

Verweist auf die HwScsiWmiSetDataBlock Routine des Treibers, bei der es sich um einen optionalen Einstiegspunkt für Miniporttreiber handelt, die WMI unterstützen. Wenn der Miniporttreiber diese Routine nicht implementiert, muss dieses Element auf NULL-

SetWmiDataItem

Verweist auf die HwScsiWmiSetDataItem Routine des Treibers, bei der es sich um einen optionalen Einstiegspunkt für Miniporttreiber handelt, die WMI unterstützen. Wenn der Miniporttreiber diese Routine nicht implementiert, muss dieses Element auf NULL-festgelegt werden.

ExecuteWmiMethod

Verweist auf die HwScsiWmiExecuteMethod Routine des Treibers, bei der es sich um einen optionalen Einstiegspunkt für Miniporttreiber handelt, die WMI unterstützen. Wenn der Miniporttreiber diese Routine nicht implementiert, muss dieses Element auf NULL-

WmiFunctionControl

Verweist auf die HwScsiWmiFunctionControl Routine des Treibers, bei der es sich um einen optionalen Einstiegspunkt für Miniporttreiber handelt, die WMI unterstützen. Wenn der Miniporttreiber diese Routine nicht implementiert, muss dieses Element auf NULL-festgelegt werden.

Bemerkungen

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

Wenn der Miniporttreiber einen SRB empfängt, in dem das 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 durch Aufrufen der geeigneten HwScsiWmiXxx-Routine des Miniporttreibers.

Wenn der Miniporttreiber keine optionale HwScsiWmiXxx-Routine implementiert, gibt der Porttreiber einen geeigneten Status an den Aufrufer zurück.