HW_ADAPTER_CONTROL回呼函式（storport.h）

會呼叫迷你埠驅動程式的 HwStorAdapterControl 例程，以執行同步作業來控制適配卡的狀態或行為，例如停止或重新啟動主機總線適配卡（HBA）以進行電源管理。

語法

HW_ADAPTER_CONTROL HwAdapterControl;

SCSI_ADAPTER_CONTROL_STATUS HwAdapterControl(
  [in] PVOID DeviceExtension,
  [in] SCSI_ADAPTER_CONTROL_TYPE ControlType,
  [in] PVOID Parameters
)
{...}

參數

[in] DeviceExtension

迷你埠驅動程式每個 HBA 儲存區域的指標。

[in] ControlType

指定配接器控制作業的 SCSI_ADAPTER_CONTROL_TYPE 值，其中每個控件類型都會由迷你埠驅動程式起始動作。如需詳細資訊，請參閱 SCSI_ADAPTER_CONTROL_TYPE。

[in] Parameters

結構或值的指標，其中包含與 ControlType相關的資訊，如果控件類型不使用結構，則為 NULL。所有結構都是呼叫端配置的。如需詳細資訊，請參閱 SCSI_ADAPTER_CONTROL_TYPE。

傳回值

根據控件類型，HwStorAdapterControl 會傳回下列其中一個SCSI_ADAPTER_CONTROL_STATUS值：

傳回碼	描述
ScsiAdapterControlSuccess	迷你埠驅動程式已順利完成要求的作業。目前，HwStorAdapterControl 必須針對所有控件類型傳回此值。
ScsiAdapterControlUnsuccessful	配接器控制作業未成功。

言論

HwStorAdapterControl 是必要函式。

Storport 會呼叫迷你埠的 HwStorAdapterControlScsiQuerySupportedControlTypes HBA 初始化之後，但在第一個 I/O 之前。迷你埠驅動程式會填入 SCSI_SUPPORTED_CONTROL_TYPE_LIST 結構，Parameters 其支援的作業。 HwStorAdapterControl 從此呼叫傳回之後，Storport 驅動程式只會針對迷你埠支援的作業呼叫 miniport 驅動程式的 HwStorAdapterControl 回呼。

由於搭配 Storport 驅動程式使用的迷你埠驅動程式必須支援隨插即用（PnP），迷你埠必須支援 ScsiStopAdapter，ScsiRestartAdapter 控件類型。

下表列出發出控件類型時取得的目前 IRQL 和微調鎖定。

控制件類型	IRQL	微調鎖定
ScsiQuerySupportedControlTypes	PASSIVE_LEVEL	沒有
ScsiStopAdapter	DIRQL	InterruptLock
ScsiRestartAdapter	DIRQL	InterruptLock
ScsiSetBootConfig	PASSIVE_LEVEL	沒有
ScsiSetRunningConfig	PASSIVE_LEVEL	沒有
ScsiPowerSettingNotification	PASSIVE_LEVEL	沒有
ScsiAdapterPower	<= DISPATCH_LEVEL	沒有
ScsiAdapterPoFxPowerRequired	<= DISPATCH_LEVEL	沒有
ScsiAdapterPoFxPowerActive	<= DISPATCH_LEVEL	沒有
ScsiAdapterPoFxPowerSetFState	<= DISPATCH_LEVEL	沒有
ScsiAdapterPoFxPowerControl	<= DISPATCH_LEVEL	沒有
ScsiAdapterPrepareForBusReScan	PASSIVE_LEVEL	沒有
ScsiAdapterSystemPowerHints	PASSIVE_LEVEL	沒有
ScsiAdapterFilterResourceRequirements	< DISPATCH_LEVEL	沒有
ScsiAdapterPoFxMaxOperationalPower	PASSIVE_LEVEL	沒有
ScsiAdapterPoFxSetPerfState	<= DISPATCH_LEVEL	沒有
ScsiAdapterSurpriseRemoval	< DISPATCH_LEVEL	沒有
ScsiAdapterSerialNumber	< DISPATCH_LEVEL	沒有
ScsiAdapterCryptoOperation	PASSIVE_LEVEL	沒有
ScsiAdapterQueryFruId	PASSIVE_LEVEL	沒有
ScsiAdapterSetEventLogging	PASSIVE_LEVEL	沒有

HwStorAdapterControl 的名稱只是佔位符。此例程的實際原型定義於 storport.h ，如下所示：

typedef
SCSI_ADAPTER_CONTROL_STATUS
HW_ADAPTER_CONTROL (
  _In_ PVOID  DeviceExtension,
  _In_ SCSI_ADAPTER_CONTROL_TYPE  ControlType,
  _In_ PVOID  Parameters
  );

例子

若要定義 HwStorAdapterControl 回呼函式，您必須先提供函式宣告，以識別您要定義的回呼函式類型。 Windows 提供一組驅動程式的回呼函式類型。使用回呼函式類型宣告函式有助於驅動程式的程式代碼分析、靜態驅動程式驗證器（SDV）和其他驗證工具尋找錯誤，而且是撰寫 Windows作系統驅動程式的需求。

例如，若要定義名為 MyHwAdapterControl的 HwStorAdapterControl 回呼例程，請使用 HW_ADAPTER_CONTROL 類型，如下列程式代碼範例所示：

HW_ADAPTER_CONTROL MyHwAdapterControl;

然後，實作回呼例程，如下所示：

_Use_decl_annotations_
SCSI_ADAPTER_CONTROL_STATUS
MyHwAdapterControl (
  _In_ PVOID  DeviceExtension,
  _In_ SCSI_ADAPTER_CONTROL_TYPE  ControlType,
  _In_ PVOID  Parameters
  );
  {
      ...
  }

HW_ADAPTER_CONTROL 函式類型定義於 Storport.h 頭檔中。若要在執行程式代碼分析工具時更準確地識別錯誤，請務必將 Use_decl_annotations 批註新增至函式定義。 Use_decl_annotations 批注可確保在頭檔中套用至 HW_ADAPTER_CONTROL 函式類型的批注。如需函式宣告需求的詳細資訊，請參閱使用 Storport 驅動程式的函式角色類型來宣告函式。如需 Use_decl_annotations的相關信息，請參閱批注函式行為。