estrutura SCSI_WMILIB_CONTEXT (scsiwmi.h)

Artigo
08/07/2023

Uma estrutura SCSI_WMILIB_CONTEXT fornece informações de registro para os dados e blocos de eventos de um driver de miniport e define pontos de entrada para as rotinas de retorno de chamada HwScsiWmiXxx do driver de miniport.

Nota Os modelos de driver de porta SCSI e driver de miniporto SCSI podem ser alterados ou indisponíveis no futuro. Em vez disso, recomendamos usar os modelos de driver do Storport e do driver de miniporto storport .

Sintaxe

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;

Membros

GuidCount

Especifica o número de estruturas na matriz SCSIWMIGUIDREGINFO em GuidList.

GuidList

Aponta para uma matriz de estruturas GuidCount SCSIWMIGUIDREGINFO que contêm informações de registro para cada bloco.

QueryWmiRegInfo

Aponta para a rotina HwScsiWmiQueryReginfo do driver, que é um ponto de entrada necessário para drivers de miniporte que dão suporte ao WMI.

QueryWmiDataBlock

Aponta para a rotina HwScsiWmiQueryDataBlock do driver, que é um ponto de entrada necessário para drivers de miniporte que dão suporte ao WMI.

SetWmiDataBlock

Aponta para a rotina HwScsiWmiSetDataBlock do driver, que é um ponto de entrada opcional para drivers de miniportuário que dão suporte ao WMI. Se o driver de miniporte não implementar essa rotina, ele deverá definir esse membro como NULL

SetWmiDataItem

Aponta para a rotina HwScsiWmiSetDataItem do driver, que é um ponto de entrada opcional para drivers de miniport que dão suporte ao WMI. Se o driver de miniporte não implementar essa rotina, ele deverá definir esse membro como NULL.

ExecuteWmiMethod

Aponta para a rotina HwScsiWmiExecuteMethod do driver, que é um ponto de entrada opcional para drivers de miniport que dão suporte ao WMI. Se o driver de miniporte não implementar essa rotina, ele deverá definir esse membro como NULL

WmiFunctionControl

Aponta para a rotina HwScsiWmiFunctionControl do driver, que é um ponto de entrada opcional para drivers de miniportuário que dão suporte ao WMI. Se o driver de miniporte não implementar essa rotina, ele deverá definir esse membro como NULL.

Comentários

Um driver de miniporto SCSI que dá suporte ao WMI armazena uma estrutura de SCSI_WMILIB_CONTEXT inicializada (ou um ponteiro para essa estrutura) em sua extensão de dispositivo. Um driver de miniporto pode usar a mesma estrutura SCSI_WMILIB_CONTEXT para vários objetos de dispositivo se cada objeto de dispositivo fornecer o mesmo conjunto de blocos de dados.

Quando o driver de miniporto recebe um SRB no qual o membro function é definido como SRB_FUNCTION_WMI, ele chama ScsiPortWmiDispatchFunction com parâmetros de solicitação, incluindo um ponteiro para uma estrutura inicializada SCSI_WMILIB_CONTEXT. ScsiPortWmiDispatchFunction manipula a solicitação chamando a rotina apropriada do HwScsiWmiXxx do driver de miniport.

Se o driver de miniporto não implementar uma rotina HwScsiWmiXxx opcional, o driver de porta retornará uma status apropriada para o chamador.