struttura SCSI_WMILIB_CONTEXT (scsiwmi.h)

Articolo
02/07/2025

Una struttura SCSI_WMILIB_CONTEXT fornisce informazioni di registrazione per i dati e i blocchi eventi di un driver miniport e definisce i punti di ingresso per le routine di callback del driver miniport HwScsiWmiXxx.

Nota I modelli di driver porta SCSI e miniport SCSI potrebbero essere modificati o non disponibili in futuro. È invece consigliabile usare driver Storport e modelli di driver miniport Storport.

Sintassi

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;

Membri

GuidCount

Specifica il numero di strutture nella matrice SCSIWMIGUIDREGINFO in GuidList.

GuidList

Punta a una matrice di GuidCount strutture SCSIWMIGUIDREGINFO che contengono informazioni di registrazione per ogni blocco.

QueryWmiRegInfo

Punta alla routine di HwScsiWmiQueryReginfo del driver, un punto di ingresso obbligatorio per i driver miniport che supportano WMI.

QueryWmiDataBlock

Punta alla routine HwScsiWmiQueryDataBlock del driver, un punto di ingresso obbligatorio per i driver miniport che supportano WMI.

SetWmiDataBlock

Punta alla routine HwScsiWmiSetDataBlock del driver, che è un punto di ingresso facoltativo per i driver miniport che supportano WMI. Se il driver miniport non implementa questa routine, deve impostare questo membro su NULL

SetWmiDataItem

Punta alla routine HwScsiWmiSetDataItem del driver, che è un punto di ingresso facoltativo per i driver miniport che supportano WMI. Se il driver miniport non implementa questa routine, deve impostare questo membro su NULL.

ExecuteWmiMethod

Punta alla routine HwScsiWmiExecuteMethod del driver, che è un punto di ingresso facoltativo per i driver miniport che supportano WMI. Se il driver miniport non implementa questa routine, deve impostare questo membro su NULL

WmiFunctionControl

Punta alla routine HwScsiWmiFunctionControl del driver, che è un punto di ingresso facoltativo per i driver miniport che supportano WMI. Se il driver miniport non implementa questa routine, deve impostare questo membro su NULL.

Osservazioni

Un driver miniport SCSI che supporta WMI archivia una struttura di SCSI_WMILIB_CONTEXT inizializzata (o un puntatore a tale struttura) nell'estensione del dispositivo. Un driver miniport può usare la stessa struttura SCSI_WMILIB_CONTEXT per più oggetti dispositivo se ogni oggetto dispositivo fornisce lo stesso set di blocchi di dati.

Quando il driver miniport riceve un SRB in cui il membro funzione è impostato su SRB_FUNCTION_WMI, chiama ScsiPortWmiDispatchFunction con parametri di richiesta, incluso un puntatore a una struttura di SCSI_WMILIB_CONTEXT inizializzata. ScsiPortWmiDispatchFunction gestisce la richiesta chiamando la routine HwScsiWmiXxx appropriata del driver miniport.

Se il driver miniport non implementa una routine HwScsiWmiXxx facoltativa, il driver della porta restituisce uno stato appropriato al chiamante.