Macro ScsiPortWmiFireAdapterEvent (scsiwmi.h)

Articolo
02/07/2025

La routine ScsiPortWmiFireAdapterEvent invia un evento associato a un'unità di adattatore al driver della porta per il recapito ai consumer di dati WMI che hanno richiesto la notifica dell'evento.

Nota I modelli di driver porta SCSI e miniport SCSI potrebbero essere modificati o non disponibili in futuro. È invece consigliabile usare driver Storport e modelli di driver miniport Storport.

Sintassi

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

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo hardware. Si tratta di un'area di archiviazione per HBA che il driver della porta alloca e inizializza per conto del driver miniport. I driver Miniport in genere archiviano informazioni specifiche di HBA in questa estensione, ad esempio lo stato dell'HBA e gli intervalli di accesso mappati dell'HBA. Questa area è disponibile per il driver miniport nel DeviceExtension->HwDeviceExtension membro dell'oggetto dispositivo dell'HBA subito dopo che il driver miniport chiama ScsiPortInitialize. Il driver della porta libera questa memoria quando rimuove il dispositivo.

[in] Guid

Puntatore al GUID che rappresenta il blocco eventi.

[in] InstanceIndex

Se il blocco di eventi ha più istanze, specifica l'indice dell'istanza.

[in] EventDataSize

Specifica il numero di byte di dati in EventData, non inclusi i byte di riempimento all'inizio del buffer dei dati dell'evento. Se non vengono generati dati per un evento, EventDataSize deve essere impostato su zero.

[in] EventData

Puntatore a un buffer allocato dal driver miniport contenente i dati generati dal driver miniport per l'evento. Il buffer deve avere almeno le dimensioni dei dati dell'evento più 0x40 byte del riquadro all'inizio del buffer.

Valore restituito

Nessuno

Osservazioni

Questa routine è una versione semplificata della routine ScsiPortWmiFireLogicalUnitEvent. Mentre ScsiPortWmiFireLogicalUnitEvent può essere usato per notificare al driver di porta gli eventi associati a adattatori e dispositivi di archiviazione, ScsiPortWmiFireAdapterEvent viene usato per notificare al driver di porta solo gli eventi associati alle schede.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	scsiwmi.h (include Miniport.h, Scsi.h)

Vedere anche

ScsiPortWmiFireLogicalUnitEvent

Condividi tramite