HW_STATE_CHANGEコールバック関数 (storport.h)

StorPortStateChangeDetected からの通知が処理された後に呼び出されるミニポート指定のコールバック。

構文

HW_STATE_CHANGE HwStateChange;

void HwStateChange(
                 PVOID HwDeviceExtension,
  [in, optional] PVOID Context,
  [in]           SHORT AddressType,
  [in]           PVOID Address,
  [in]           ULONG Status
)
{...}

パラメーター

HwDeviceExtension

[入力]ミニポート ドライバーの HBA ごとの記憶域へのポインター。

[in, optional] Context

StorPortStateChangeDetected の呼び出しでミニポートによって HwStateChangeContext として提供されるコンテキスト。

[in] AddressType

[アドレス] のアドレスの種類。

[in] Address

状態変更が処理されたエンティティの STOR_ADDRESS 構造体へのポインター。

[in] Status

状態変更通知の処理状態。

戻り値

なし

解説

HwStorStateChange は、Storport によって取得された StartIo ロックで呼び出されます。

このコールバックを使用すると、ミニポートは、ハードウェアの追加または削除後に必要な追加の処理を実行できます。 HBA ポートまたはバスでハードウェアの変更が発生した場合、ミニポートは StorPortStateChangeDetected を呼び出してイベントのシステムに警告できます。

Status の値が<0x80000000の場合、通知処理は成功しました。 それ以外の場合、通知プロセスは失敗しました。

名前 HwStorStateChange は、StorPortStateChangeDetected の HwStateChange パラメーターによって指されるミニポート関数のプレースホルダーにすぎません。 このルーチンの実際のプロトタイプは、 Storport.h で次のように定義されています。

typedef
VOID
HW_STATE_CHANGE (
    _In_ PVOID HwDeviceExtension,
    _In_opt_ PVOID Context,
    _In_ SHORT AddressType,
    _In_ PVOID Address,
    _In_ ULONG Status
    );

要件

要件	値
サポートされている最小のクライアント	Windows 8以降のバージョンの Windows で使用できます。
対象プラットフォーム	ユニバーサル
Header	storport.h (Storport.h を含む)
IRQL	ディスパッチ

こちらもご覧ください

STOR_ADDRESS

StorPortStateChangeDetected