ScsiPortWmiFireAdapterEvent macro

Description

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.

Parameters

HwDeviceExtension [in]

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.

Guid [in]

Pointer to the GUID that represents the event block.

InstanceIndex [in]

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

EventDataSize [in]

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.

EventData [in]

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.

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.

See also

ScsiPortWmiFireLogicalUnitEvent