Estrutura SCSIWMIGUIDREGINFO (scsiwmi.h)

  • Artigo

A estrutura SCSIWMIGUIDREGINFO contém informações sobre um determinado bloco de dados ou eventos com suporte por um miniportor SCSI.

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 {
  LPCGUID Guid;
  ULONG   InstanceCount;
  ULONG   Flags;
} SCSIWMIGUIDREGINFO, *PSCSIWMIGUIDREGINFO;

Membros

Guid

Aponta para o GUID que identifica o bloco.

InstanceCount

Especifica o número de instâncias definidas para o bloco.

Flags

Indica características do bloco. O driver de porta SCSI define todos, exceto os seguintes WMIREG_FLAG_XXX em nome do driver de miniporto. Um driver de miniporte pode definir um ou mais dos seguintes sinalizadores:

WMIREG_FLAG_EVENT_ONLY_GUID

O bloco pode ser habilitado ou desabilitado apenas como um evento e não pode ser consultado ou definido. Se esse sinalizador estiver claro, o bloco também poderá ser consultado ou definido.

WMIREG_FLAG_EXPENSIVE

Solicita que o driver de porta envie um SRB de coleta de habilitação na primeira vez que um consumidor de dados abre o bloco de dados e um SRB de coleta de desabilitação quando o último consumidor de dados fecha o bloco de dados. Isso é recomendado se a coleta desses dados afetar o desempenho. Um driver de miniporte não precisa coletar os dados até que um consumidor de dados os solicite explicitamente abrindo o bloco.

WMIREG_FLAG_REMOVE_GUID

Remove o suporte para um bloco registrado anteriormente quando definido.

Comentários

O driver de miniporto passa um ponteiro para um SCSI_WMILIB_CONTEXT que contém uma matriz SCSIWMIREGGUID no parâmetro WmiLibInfo de ScsiPortWmiDispatchFunction. O driver de miniporte passa essas informações sempre que chama ScsiPortWmiDispatchFunction. Cada estrutura SCSIWMIREGGUID na matriz representa um dos dados ou blocos de eventos do driver de miniport.

A matriz SCSIWMIREGGUID de um driver de miniport deve incluir quaisquer blocos de dados padrão definidos em wmicore.mof para seu tipo de dispositivo e pode incluir dados definidos pelo miniportor e blocos de eventos. Um driver de miniporte define dados personalizados e blocos de eventos em um arquivo MOF, que é compilado como um recurso anexado à imagem binária do driver de miniport e especificado no parâmetro MofResourceName da rotina HwScsiWmiQueryReginfo do driver de miniport.

Para obter mais informações sobre como definir blocos, Instrumentação de Gerenciamento do Windows.

Requisitos

Requisito Valor
Cabeçalho scsiwmi.h (inclua Scsiwmi.h)

Confira também

HwScsiWmiQueryReginfo

SCSI_WMILIB_CONTEXT

ScsiPortWmiDispatchFunction