共用方式為

ScsiPortWmiFireLogicalUnitEvent 函式 （scsiwmi.h）

  • 發行項

ScsiPortWmiFireLogicalUnitEvent 例程會將與邏輯單元相關聯的事件傳送至埠驅動程式，以傳遞至已要求事件通知的 WMI 數據取用者。

注意 SCSI 連接埠驅動程式和 SCSI 迷你埠驅動程式模型未來可能會改變或無法使用。 相反地，我們建議使用 Storport 驅動程式 和 Storport miniport 驅動程式模型。
 

語法

void ScsiPortWmiFireLogicalUnitEvent(
  [in] PVOID  HwDeviceExtension,
  [in] UCHAR  PathId,
  [in] UCHAR  TargetId,
  [in] UCHAR  Lun,
  [in] LPGUID Guid,
  [in] ULONG  InstanceIndex,
  [in] ULONG  EventDataSize,
  [in] PVOID  EventData
);

參數

[in] HwDeviceExtension

硬體裝置延伸模組的指標。 這是埠驅動程式代表迷你埠驅動程式配置和初始化的每個 HBA 儲存區域。 迷你埠驅動程式通常會在此延伸模組中儲存 HBA 特定資訊，例如 HBA 的狀態和 HBA 的對應存取範圍。 在迷你埠驅動程式呼叫 ScsiPortInitialize之後，此區域可供 DeviceExtension->HwDeviceExtension HBA 裝置對象的成員使用。 埠驅動程式會在移除裝置時釋放此記憶體。

[in] PathId

識別 SCSI 總線;SP_UNTAGGED表示由 HBA 控制的所有公交車。

[in] TargetId

識別指定總線上的目標控制器或裝置：SP_UNTAGGED表示公共汽車上的所有目標。

[in] Lun

識別指定目標控制器或裝置的邏輯單元;SP_UNTAGGED表示指定總線上指定目標控制器的所有邏輯單元。

[in] Guid

代表事件區塊之 GUID 的指標。

[in] InstanceIndex

如果事件區塊有多個實例，請指定 實例的索引。

[in] EventDataSize

指定 EventData的數據位元組數目，不包含事件數據緩衝區開頭的填補位元組。 如果未為事件產生任何數據，EventDataSize 應設定為零。

[in] EventData

迷你埠驅動程式配置的緩衝區指標，其中包含迷你埠驅動程序針對事件所產生的數據。 緩衝區至少必須是事件數據的大小，加上緩衝區開頭的0x40填補位元組。

傳回值

沒有

言論

迷你埠驅動程式會呼叫 ScsiPortWmiFireLogicalUnitEvent，將與配接器或邏輯單元相關聯的事件傳送給已要求事件通知的所有數據取用者。

只有當迷你埠驅動程式先前已由迷你埠驅動程式的 HwScsiWmiFunctionControl 例程啟用時，迷你埠驅動程式才會傳送事件。

驅動程式應該將事件數據寫入 EventData 所指向的緩衝區， 位移0x40。 SCSI WMI 會使用第一個0x40個字節。 如果未使用 事件傳回任何數據，則 EventData 長度應該0x40位元組。

要求

要求 價值
目標平臺 桌面
標頭 scsiwmi.h （包括 Miniport.h、Scsi.h）

另請參閱

HwScsiWmiFunctionControl