estructura de SCSI_WMILIB_CONTEXT (scsiwmi.h)

Artículo
08/07/2023

Una estructura de SCSI_WMILIB_CONTEXT proporciona información de registro para los bloques de eventos y datos de un controlador de miniporte y define los puntos de entrada para las rutinas de devolución de llamada HwScsiWmiXxx del controlador de miniporte.

Nota Los modelos del controlador de puerto SCSI y del controlador de miniporte SCSI pueden modificarse o no estar disponibles en el futuro. En su lugar, se recomienda usar el controlador Storport y los modelos de controlador de miniport storport .

Sintaxis

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;

Miembros

GuidCount

Especifica el número de estructuras de la matriz SCSIWMIGUIDREGINFO en GuidList.

GuidList

Apunta a una matriz de estructuras GuidCount SCSIWMIGUIDREGINFO que contienen información de registro para cada bloque.

QueryWmiRegInfo

Apunta a la rutina HwScsiWmiQueryReginfo del controlador, que es un punto de entrada necesario para los controladores de miniporte que admiten WMI.

QueryWmiDataBlock

Apunta a la rutina HwScsiWmiQueryDataBlock del controlador, que es un punto de entrada necesario para los controladores de minipuerto que admiten WMI.

SetWmiDataBlock

Apunta a la rutina HwScsiWmiSetDataBlock del controlador, que es un punto de entrada opcional para los controladores de miniporte que admiten WMI. Si el controlador de miniporte no implementa esta rutina, debe establecer este miembro en NULL.

SetWmiDataItem

Apunta a la rutina HwScsiWmiSetDataItem del controlador, que es un punto de entrada opcional para los controladores de minipuerto que admiten WMI. Si el controlador de miniporte no implementa esta rutina, debe establecer este miembro en NULL.

ExecuteWmiMethod

Apunta a la rutina HwScsiWmiExecuteMethod del controlador, que es un punto de entrada opcional para los controladores de miniporte que admiten WMI. Si el controlador de miniporte no implementa esta rutina, debe establecer este miembro en NULL.

WmiFunctionControl

Apunta a la rutina HwScsiWmiFunctionControl del controlador, que es un punto de entrada opcional para los controladores de miniporte que admiten WMI. Si el controlador de miniporte no implementa esta rutina, debe establecer este miembro en NULL.

Comentarios

Un controlador de miniporte SCSI que admite WMI almacena una estructura de SCSI_WMILIB_CONTEXT inicializada (o un puntero a dicha estructura) en su extensión de dispositivo. Un controlador de minipuerto puede usar la misma estructura de SCSI_WMILIB_CONTEXT para varios objetos de dispositivo si cada objeto de dispositivo proporciona el mismo conjunto de bloques de datos.

Cuando el controlador de miniporte recibe un SRB en el que el miembro Function se establece en SRB_FUNCTION_WMI, llama a ScsiPortWmiDispatchFunction con parámetros de solicitud, incluido un puntero a una estructura de SCSI_WMILIB_CONTEXT inicializada. ScsiPortWmiDispatchFunction controla la solicitud llamando a la rutina HwScsiWmiXxx adecuada del controlador de miniport.

Si el controlador de miniporte no implementa una rutina HwScsiWmiXxx opcional, el controlador de puerto devuelve un estado adecuado al autor de la llamada.