SCSI_WMILIB_CONTEXT struttura (scsiwmi.h)

Articolo
08/07/2023

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 HwScsiWmiXxx del driver miniport.

Nota I modelli di driver di porta SCSI e miniport SCSI possono essere modificati o non disponibili in futuro. È invece consigliabile usare i modelli di driver Storport e 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;

Members

GuidCount

Specifica il numero di strutture nella matrice SCSIWMIGUIDREGINFO in GuidList.

GuidList

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

QueryWmiRegInfo

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

QueryWmiDataBlock

Punta alla routine HwScsiWmiQueryDataBlock del driver, che è 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.

Commenti

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 dati.

Quando il driver miniport riceve una SRB in cui il membro della 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 di porta restituisce uno stato appropriato al chiamante.