ScsiPortWmiFireAdapterEvent マクロ (scsiwmi.h)

ScsiPortWmiFireAdapterEvent ルーチンは、イベントの通知を要求した WMI データ コンシューマーに配信するために、アダプター ユニットに関連付けられているイベントをポート ドライバーに送信します。

注 SCSI ポート ドライバーと SCSI ミニポート ドライバー モデルは、今後変更されたり使用できなくなったりする可能性があります。 代わりに、Storport ドライバー を使用し、Storport ミニポート ドライバー モデル することをお勧めします。

 

構文

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

パラメーター

[in] HwDeviceExtension

ハードウェア デバイス拡張機能へのポインター。 これは、ポート ドライバーが割り当て、ミニポート ドライバーの代わりに初期化する HBA ごとの記憶域です。 ミニポート ドライバーは通常、HBA の状態や HBA のマップされたアクセス範囲など、この拡張機能に HBA 固有の情報を格納します。 この領域は、ミニポート ドライバーが ScsiPortInitialize 呼び出した直後に、HBA のデバイス オブジェクトの メンバーである DeviceExtension->HwDeviceExtension 内のミニポート ドライバーで使用できます。 ポート ドライバーは、デバイスを削除すると、このメモリを解放します。

[in] Guid

イベント ブロックを表す GUID へのポインター。

[in] InstanceIndex

イベント ブロックに複数のインスタンスがある場合は、インスタンスのインデックスを指定します。

[in] EventDataSize

EventData データのバイト数を指定します。イベント データ バッファーの先頭のパッド バイトは含まれません。 イベントのデータが生成されない場合は、EventDataSize 0 に設定する必要があります。

[in] EventData

イベントのミニポート ドライバーによって生成されたデータを含むミニポート ドライバーによって割り当てられたバッファーへのポインター。 バッファーは、少なくともイベント データのサイズとバッファーの先頭0x40パッド バイトである必要があります。

戻り値

何一つ

備考

このルーチンは、ScsiPortWmiFireLogicalUnitEvent ルーチンの簡略化されたバージョンです。 一方、ScsiPortWmiFireLogicalUnitEvent を使用して、アダプターとストレージ デバイスに関連付けられているイベントをポート ドライバーに通知できます。ScsiPortWmiFireAdapterEvent は、アダプターに関連付けられているイベントのみをポート ドライバーに通知するために使用されます。

必要条件

要件	価値
ターゲット プラットフォーム の	デスクトップ
ヘッダー	scsiwmi.h (ミニポート h、Scsi.h を含む)

関連項目

ScsiPortWmiFireLogicalUnitEvent の