Macro ScsiPortWmiFireAdapterEvent (scsiwmi.h)

Artigo
02/07/2025

A rotina ScsiPortWmiFireAdapterEvent envia um evento associado a uma unidade de adaptador para o driver de porta para entrega aos consumidores de dados WMI que solicitaram a notificação do evento.

Observação o driver de porta SCSI e os modelos de driver de miniporto SCSI podem estar alterados ou indisponíveis no futuro. Em vez disso, recomendamos usar o de driver do Storport e miniporto storport modelos de driver.

Sintaxe

void ScsiPortWmiFireAdapterEvent(
  [in]  HwDeviceExtension,
  [in]  Guid,
  [in]  InstanceIndex,
  [in]  EventDataSize,
  [in]  EventData
);

Parâmetros

[in] HwDeviceExtension

Ponteiro para a extensão do dispositivo de hardware. Essa é uma área de armazenamento por HBA que o driver de porta aloca e inicializa em nome do driver de miniporto. Os drivers de miniporto geralmente armazenam informações específicas do HBA nessa extensão, como o estado do HBA e os intervalos de acesso mapeados do HBA. Essa área está disponível para o driver de miniporto no DeviceExtension->HwDeviceExtension membro do objeto de dispositivo do HBA imediatamente após o driver de miniporto chamar ScsiPortInitialize. O driver de porta libera essa memória quando remove o dispositivo.

[in] Guid

Ponteiro para o GUID que representa o bloco de eventos.

[in] InstanceIndex

Se o bloco de eventos tiver várias instâncias, especifica o índice da instância.

[in] EventDataSize

Especifica o número de bytes de dados em EventData, não incluindo bytes de pad no início do buffer de dados do evento. Se nenhum dado for gerado para um evento, EventDataSize deverá ser definido como zero.

[in] EventData

Ponteiro para um buffer alocado pelo driver de miniport contendo dados gerados pelo driver de miniporto para o evento. O buffer deve ter pelo menos o tamanho dos dados de evento mais 0x40 bytes de pad no início do buffer.

Valor de retorno

Nenhum

Observações

Essa rotina é uma versão simplificada da rotina de ScsiPortWmiFireLogicalUnitEvent. Enquanto, ScsiPortWmiFireLogicalUnitEvent pode ser usado para notificar o driver de porta de eventos associados a adaptadores e dispositivos de armazenamento, ScsiPortWmiFireAdapterEvent é usado para notificar o driver de porta de eventos associados somente aos adaptadores.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	scsiwmi.h (inclua Miniport.h, Scsi.h)

Consulte também

ScsiPortWmiFireLogicalUnitEvent

Compartilhar via