共用方式為

HW_FIND_ADAPTER回呼函式 （storport.h）

  • 發行項

HwStorFindAdapter 例程會使用提供的組態來判斷是否支援特定的 HBA，如果是，則傳回該配接器的組態資訊。

語法

HW_FIND_ADAPTER HwFindAdapter;

ULONG HwFindAdapter(
           PVOID DeviceExtension,
  [in]     PVOID HwContext,
  [in]     PVOID BusInformation,
  [in]     PCHAR ArgumentString,
  [in/out] PPORT_CONFIGURATION_INFORMATION ConfigInfo,
  [in]     PBOOLEAN Reserved3
)
{...}

參數

DeviceExtension

為每個配接器儲存區域提供 。

[in] HwContext

設定為 NULL。

[in] BusInformation

設定為 NULL。

[in] ArgumentString

提供具有驅動程式內容資訊的 NULL終止字串。

[in/out] ConfigInfo

提供迷你埠驅動程式在初始化期間所使用的初始化 PORT_CONFIGURATION_INFORMATION 結構。

[in] Reserved3

保留供系統使用。

傳回值

HwStorFindAdapter 必須傳回下列其中一個狀態值：

傳回碼 描述
SP_RETURN_FOUND 指出找到支援的 HBA，且 HBA 相關的組態資訊已成功判斷並設定在 PORT_CONFIGURATION_INFORMATION 結構中。
SP_RETURN_ERROR 表示找到 HBA，但取得組態資訊時發生錯誤。 可能的話，應該使用 StorPortLogError記錄這類錯誤。
SP_RETURN_BAD_CONFIG 表示提供的組態資訊對配接器無效。
SP_RETURN_NOT_FOUND 表示針對提供的組態資訊找不到任何支援的 HBA。

言論

由於 Storport 驅動程式僅支援即插即用 （PnP） 裝置，因此不會將 HwContext 和 BusInformation 參數提供給非虛擬迷你埠驅動程式 HwStorFindAdapter。

HwStorFindAdapter 必須在 ConfigInfo 結構中設定 MaximumTransferLength 和 NumberOfPhysicalBreaks 字段。 除了這些欄位以外，PORT_CONFIGURATION_INFORMATION 結構一律會完整指定啟動配接器所需的所有配接器資源。

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

typedef
ULONG
HW_FIND_ADAPTER (
  _In_ PVOID  DeviceExtension,
  _In_ PVOID  HwContext,
  _In_ PVOID  BusInformation,
  _In_z_ PCHAR  ArgumentString,
  _Inout_ PPORT_CONFIGURATION_INFORMATION  ConfigInfo,
  _In_ PBOOLEAN  Reserved3
  );

在大部分情況下，StorPort 會在 IRQL == PASSIVE_LEVEL呼叫 HwStorFindAdapter 例程，而不需要取得任何微調鎖定。 例外狀況是迷你埠不支援使用 ScsiRestartAdapter 控件類型呼叫 HwStorAdaptorControl。 在此情況下，StorPort 會呼叫 HwStorFindAdapter 和 HwStorInitialize來重新初始化適配卡。 在此情況下，HwStorFindAdapter 會在 IRQL == DISPATCH_LEVEL呼叫。 此外，在傾印模式中，HwStorFindAdapter 會在 IRQL == HIGH_LEVEL呼叫。

例子

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

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

HW_FIND_ADAPTER MyHwFindAdapter;

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

_Use_decl_annotations_
ULONG
MyHwFindAdapter (
  _In_ PVOID  DeviceExtension,
  _In_ PVOID  HwContext,
  _In_ PVOID  BusInformation,
  _In_z_ PCHAR  ArgumentString,
  _Inout_ PPORT_CONFIGURATION_INFORMATION  ConfigInfo,
  _In_ PBOOLEAN  Reserved3
  );
  {
      ...
  }

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

要求

要求 價值
目標平臺 普遍
標頭 storport.h （包括 Storport.h）
IRQL PASSIVE_LEVEL （請參閱一節。

另請參閱

HwStorInitialize

PORT_CONFIGURATION_INFORMATION

StorPortInitialize

StorPortLogError