Expand Minimize

ScsiPortWmiFireAdapterEvent macro

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.

Syntax


VOID ScsiPortWmiFireAdapterEvent(
  [in]  PVOID HwDeviceExtension,
  [in]  LPGUID Guid,
  [in]  ULONG InstanceIndex,
  [in]  ULONG EventDataSize,
  [in]  PVOID EventData
);

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.

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

Header

Scsiwmi.h (include Miniport.h or Scsi.h)

See also

ScsiPortWmiFireLogicalUnitEvent

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft