ScsiPortWmiFireAdapterEvent-Makro (scsiwmi.h)

Artikel
02/29/2024

Die ScsiPortWmiFireAdapterEvent-Routine sendet ein Ereignis, das einer Adaptereinheit zugeordnet ist, an den Porttreiber zur Übermittlung an WMI-Datenverbraucher, 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 wird empfohlen, die Modelle Storport-Treiber und Storport-Miniporttreiber zu verwenden.

Syntax

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

Parameter

[in] HwDeviceExtension

Zeiger auf die Hardwaregeräteerweiterung. Hierbei handelt es sich um einen HBA-Speicherbereich, den der Porttreiber im Namen des Miniporttreibers ordnet und initialisiert. Miniporttreiber speichern normalerweise HBA-spezifische Informationen in dieser Erweiterung, z. B. den Zustand des HBA und die zugeordneten Zugriffsbereiche des HBA. Dieser Bereich steht dem Miniporttreiber im DeviceExtension-HwDeviceExtension-Member> des HBA-Geräteobjekts unmittelbar nach dem Aufruf von ScsiPortInitialize durch den Miniporttreiber zur Verfügung. Der Porttreiber gibt diesen Arbeitsspeicher frei, wenn er das Gerät entfernt.

[in] Guid

Zeiger auf die GUID, die den Ereignisblock darstellt.

[in] InstanceIndex

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

[in] EventDataSize

Gibt die Anzahl der Datenbytes bei EventData an, ohne Dass padbytes am Anfang des Ereignisdatenpuffers enthalten sind. Wenn keine Daten für ein Ereignis generiert werden, sollte EventDataSize auf 0 festgelegt werden.

[in] EventData

Zeiger auf einen vom Miniporttreiber zugewiesenen Puffer mit Daten, 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

Keine

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 nur Adaptern zugeordnet sind.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	scsiwmi.h (einschließlich Miniport.h, Scsi.h)

Weitere Informationen

ScsiPortWmiFireLogicalUnitEvent

Freigeben über