SCSI_UNIT_CONTROL_TYPE列挙 (storport.h)

  • [アーティクル]

SCSI_UNIT_CONTROL_TYPE列挙には、各コントロールの種類がミニポート ドライバーによってユニットに対するアクションを開始するユニット制御操作が含まれています。 Storport は、ミニポートの HwStorUnitControl ルーチンを呼び出すときにコントロールの種類を指定します。

構文

typedef enum _SCSI_UNIT_CONTROL_TYPE {
  ScsiQuerySupportedUnitControlTypes,
  ScsiUnitUsage,
  ScsiUnitStart,
  ScsiUnitPower,
  ScsiUnitPoFxPowerInfo,
  ScsiUnitPoFxPowerRequired,
  ScsiUnitPoFxPowerActive,
  ScsiUnitPoFxPowerSetFState,
  ScsiUnitPoFxPowerControl,
  ScsiUnitRemove,
  ScsiUnitSurpriseRemoval,
  ScsiUnitRichDescription,
  ScsiUnitQueryBusType,
  ScsiUnitQueryFruId,
  ScsiUnitReportInternalData,
  ScsiUnitControlMax,
  MakeUnitControlTypeSizeOfUlong
} SCSI_UNIT_CONTROL_TYPE, *PSCSI_UNIT_CONTROL_TYPE;

定数

 
ScsiQuerySupportedUnitControlTypes
ミニポート ドライバーによって実装されたユニット制御操作を報告します。 ミニポートは、このコントロールの種類をサポートする必要があります。

Storport ドライバーは、HBA が初期化された後、最初の I/O の前に、SCSI_SUPPORTED_CONTROL_TYPE_LIST構造体を指すこのコントロールの種類とパラメーターを使用して HwStorUnitControl を呼び出します。

ミニポート ドライバーは、サポートされている操作を SCSI_SUPPORTED_CONTROL_TYPE_LIST 構造体に入力します。 HwStorUnitControl がこの呼び出しから戻った後、Storport ドライバーはミニポート ドライバーの HwStorUnitControl をミニポートでサポートされている操作に対してのみ呼び出します。
ScsiUnitUsage
サポートされている使用の種類に論理ユニットが使用されているかどうかをミニポートに通知します。 Storport は、このコントロール型と、STOR_UC_DEVICE_USAGE構造体を指す Parameters を使用して HwStorUnitControl を呼び出します。 Storport は、サポートされている使用の種類ごとに HwStorUnitControl を個別に呼び出します。
ScsiUnitStart
ユニット デバイスを起動するようにミニポートに通知します。 Storport は、このコントロールの種類と開始するユニットのSTOR_ADDR_BTL8 アドレスを指す Parameters を使用して HwStorUnitControl を呼び出します。
ScsiUnitPower
ユニットの電源オンまたは電源オフの状態を報告します。 Storport は、このコントロール型と、STOR_UNIT_CONTROL_POWER構造体を指す Parameters を使用して HwStorUnitControl を呼び出します。 ミニポートは、このコントロールの種類をサポートしている場合は、SRB_FUNCTION_POWERを持つ記憶域要求ブロックを受信しません。
ScsiUnitPoFxPowerInfo
ユニット コンポーネントでアイドル状態の電源管理が有効または無効になっている場合にミニポートに通知します。 Storport は、このコントロール型と、STOR_POFX_UNIT_POWER_INFO構造体を指す Parameters を使用して HwStorUnitControl を呼び出します。 ミニポートは、アイドル状態の電源管理が有効になっている場合、およびユニット デバイスのランタイム電源管理をサポートしている場合は、このユニット コントロール内で StorPortInitializePoFxPower を呼び出す必要があります。
ScsiUnitPoFxPowerRequired
ユニット コンポーネントに電源が必要かどうかをミニポートに通知します。 Storport は、このコントロール型と、STOR_POFX_POWER_REQUIRED_CONTEXT構造体を指す Parameters を使用して HwStorUnitControl を呼び出します。
ScsiUnitPoFxPowerActive
ユニット コンポーネントがアクティブまたはアイドル状態であることをミニポートに通知します。 Storport は、このコントロール型と、STOR_POFX_ACTIVE_CONTEXT構造体を指す Parameters を使用して HwStorUnitControl を呼び出します。
ScsiUnitPoFxPowerSetFState
ユニット コンポーネントを特定の機能電源状態 (F 状態) に設定するようにミニポートに通知します。 Storport は、このコントロール型と、STOR_POFX_FSTATE_CONTEXT構造体を指す Parameters を使用して HwStorUnitControl を呼び出します。 が StorPortInitializePoFxPower の呼び出しで複数の F 状態を指定している場合、ミニポートはこのコントロールの種類をサポートする必要があります。
ScsiUnitPoFxPowerControl
ミニポートが、電源エンジン プラグイン (PEP) によってユニットに対して開始されたプライベート電源制御操作を実行することを要求します。 Storport は、このコントロール型と、STOR_POFX_POWER_CONTROL構造体を指す Parameters を使用して HwStorUnitControl を呼び出します。
ScsiUnitRemove
ユニットが削除されたことをミニポートに通知します。 Storport は、このコントロールの種類と、削除されたユニットのSTOR_ADDR_BTL8 アドレスを指す Parameters を使用して HwStorUnitControl を呼び出します。
ScsiUnitSurpriseRemoval
ユニットが突然削除されたことをミニポートに通知します。 Storport は、このコントロールの種類と、突然削除されたユニットのSTOR_ADDR_BTL8 アドレスを指す Parameters を使用して HwStorUnitControl を呼び出します。
ScsiUnitRichDescription
デバイスが SCSI 仕様で定義されているよりも長いベンダー ID、モデル番号、またはファームウェアリビジョンを報告する場合、ミニポートはこれをサポートすることを選択できます。Storport は、このコントロール型と、STOR_RICH_DEVICE_DESCRIPTION構造体を指す Parameters を使用して HwStorUnitControl を呼び出します。
ScsiUnitQueryBusType
ミニポートが特定の論理ユニット (LUN) のバスの種類を指定するかどうかを照会します。 通常、LUN とコントローラーのバスの種類は同じバスの種類ですが、常にとは限りません。 Storport は、このコントロール型とパラメーターがSTOR_UNIT_CONTROL_QUERY_BUS_TYPE構造体を指す HwStorUnitControl を呼び出します。 Windows 10 バージョン 2004 以降で使用できます。

注

バージョン 21H1 以降Windows 10、Storport は、ミニポートが以前に StorPortFeatureBusTypeUnitControl を指定した HwFindAdapter ルーチンで StorPortSetFeatureList も呼び出した場合にのみ、このコントロールを送信します。
ScsiUnitQueryFruId
障害交換ユニット (FRU) の ID を照会します。 ミニポートがこのコントロールの種類をサポートしている場合、Storport は、このコントロールの種類とパラメーターがSTOR_FRU_ID_DESCRIPTION構造体を指す HwStorUnitControl を呼び出します。 Windows 10 バージョン 21H1 以降で使用できます。

注

Storport は、ミニポートが以前に StorPortFeatureFruIdUnitControl を指定した HwFindAdapter ルーチンで StorPortSetFeatureList も呼び出した場合にのみ、このコントロールを送信します。
ScsiUnitReportInternalData
システムで使用するために予約されています。 Windows 11 バージョン 22H2 以降で使用できます。
ScsiUnitControlMax
コントロールの種類の最大値。
MakeUnitControlTypeSizeOfUlong
この列挙体を ULONG のサイズにします。

注釈

ミニポートは、Storport が ScsiQuerySupportedControlTypes のコントロール型を使用してミニポートの HwStorUnitControl ルーチンを呼び出すときにサポートするコントロールの種類を報告します。 ミニポートがサポートするコントロールの種類の場合、Storport は、ミニポートによって実行される単位制御操作を指定するSCSI_UNIT_CONTROL_TYPE値を使用して HwStorUnitControl を呼び出します。

要件

要件 値
サポートされている最小のクライアント Windows 8
Header storport.h

こちらもご覧ください

HwStorUnitControl