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 | ディスパッチ |