ScsiPortWmiFireAdapterEvent-Makro (scsiwmi.h)

Artikel
02/07/2025

Die ScsiPortWmiFireAdapterEvent Routine sendet ein Ereignis, das einer Adaptereinheit zugeordnet ist, an den Porttreiber für die Übermittlung an WMI-Datenkunden, die eine Benachrichtigung über das Ereignis angefordert haben.

Hinweis Der SCSI-Porttreiber und die SCSI-Miniporttreibermodelle können in Zukunft geändert oder nicht mehr verfügbar sein. Stattdessen empfehlen wir die Verwendung des Storport-Treibers und Storport Miniport Treibermodelle.

Syntax

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

Parameter

[in] HwDeviceExtension

Zeiger auf die Hardwaregeräteerweiterung. Dies ist ein Speicherbereich pro HBA, den der Porttreiber im Namen des Miniporttreibers zuordnet und initialisiert. Miniporttreiber speichern in der Regel HBA-spezifische Informationen in dieser Erweiterung, z. B. den Zustand der HBA und die zugeordneten Zugriffsbereiche der HBA. Dieser Bereich steht dem Miniporttreiber im DeviceExtension->HwDeviceExtension Mitglied des Geräteobjekts der HBA unmittelbar nach dem Aufruf ScsiPortInitializezur Verfügung. Der Porttreiber gibt diesen Speicher frei, wenn es das Gerät entfernt.

[in] Guid

Zeigen Sie auf die GUID, die den Ereignisblock darstellt.

[in] InstanceIndex

Wenn der Ereignisblock über mehrere Instanzen verfügt, gibt den Index der Instanz an.

[in] EventDataSize

Gibt die Anzahl der Bytes an, die bei EventData-enthalten sind, nicht einschließlich Padbytes am Anfang des Ereignisdatenpuffers. Wenn keine Daten für ein Ereignis generiert werden, sollte EventDataSize- auf Null festgelegt werden.

[in] EventData

Zeiger auf einen vom Miniporttreiber zugewiesenen Puffer, der Daten enthält, die vom Miniporttreiber für das Ereignis generiert wurden. Der Puffer muss mindestens die Größe der Ereignisdaten plus 0x40 Padbytes am Anfang des Puffers aufweisen.

Rückgabewert

Nichts

Bemerkungen

Diese Routine ist eine vereinfachte Version der ScsiPortWmiFireLogicalUnitEvent Routine. Während ScsiPortWmiFireLogicalUnitEvent verwendet werden kann, um den Porttreiber über Ereignisse zu benachrichtigen, die mit Adaptern und Speichergeräten verbunden sind, wird ScsiPortWmiFireAdapterEvent verwendet, um den Porttreiber nur über Ereignisse zu benachrichtigen, die mit Adaptern verbunden sind.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	scsiwmi.h (include Miniport.h, Scsi.h)

Siehe auch

ScsiPortWmiFireLogicalUnitEvent

Freigeben über