Edit

Share via

ScsiPortWmiFireAdapterEvent macro (scsiwmi.h)

  • Article

The ScsiPortWmiFireAdapterEvent routine sends an event associated with an adapter unit to the port driver for delivery to WMI data consumers that have requested notification of the event.

Note  The SCSI port driver and SCSI miniport driver models may be altered or unavailable in the future. Instead, we recommend using the Storport driver and Storport miniport driver models.
 

Syntax

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

Parameters

[in] HwDeviceExtension

Pointer to the hardware device extension. This is a per-HBA storage area that the port driver allocates and initializes on behalf of the miniport driver. Miniport drivers usually store HBA-specific information in this extension, such as the state of the HBA and the HBA's mapped access ranges. This area is available to the miniport driver in the DeviceExtension->HwDeviceExtension member of the HBA's device object immediately after the miniport driver calls ScsiPortInitialize. The port driver frees this memory when it removes the device.

[in] Guid

Pointer to the GUID that represents the event block.

[in] InstanceIndex

If the event block has multiple instances, specifies the index of the instance.

[in] EventDataSize

Specifies the number of bytes of data at EventData, not including pad bytes at the beginning of the event data buffer. If no data is generated for an event, EventDataSize should be set to zero.

[in] EventData

Pointer to a miniport driver-allocated buffer containing data generated by the miniport driver for the event. The buffer must be at least the size of the event data plus 0x40 pad bytes at the beginning of the buffer.

Return value

None

Remarks

This routine is a simplified version of the ScsiPortWmiFireLogicalUnitEvent routine. Whereas, ScsiPortWmiFireLogicalUnitEvent can be used to notify the port driver of events associated with adapters and storage devices, ScsiPortWmiFireAdapterEvent is used to notify the port driver of events associated with adapters only.

Requirements

Requirement Value
Target Platform Desktop
Header scsiwmi.h (include Miniport.h, Scsi.h)

See also

ScsiPortWmiFireLogicalUnitEvent