次の方法で共有

StorPortInitialize 関数 (storport.h)

  • [アーティクル]

StorPortInitialize ルーチンは、ポート ドライバーのパラメーターと拡張データを初期化します。 StorPortInitialize は、driverEntry ルーチンミニポート ドライバーから提供されるアダプター情報も保存します。

構文

STORPORT_API ULONG StorPortInitialize(
  [in]           PVOID                   Argument1,
  [in]           PVOID                   Argument2,
  [in]           _HW_INITIALIZATION_DATA *HwInitializationData,
  [in, optional] PVOID                   HwContext
);

パラメーター

[in] Argument1

オペレーティング システムがミニポートの DriverEntry ルーチンを呼び出した最初のポインター。

[in] Argument2

オペレーティング システムがミニポートの DriverEntry ルーチンを呼び出した 2 番目のポインター。

[in] HwInitializationData

DriverEntry ルーチンのミニポート ドライバーによって設定された初期化および構成情報へのポインター。

[in, optional] HwContext

ミニポート ドライバーの HwStorFindAdapter ルーチンに渡されるコンテキスト値のアドレスです。 ポート ドライバーから構成情報を受け取るのではなく、HBA のバスをスキャンするレガシ ミニポート ドライバーのみが、このパラメーターを使用して、HwStorFindAdapterへの呼び出し間の状態 格納できます。

戻り値

StorPortInitializeによって実行される初期化アクションの結果。 ミニポート ドライバーは、DriverEntry ルーチンの戻り値としてこの値を返します。

StorPortInitialize は、次のいずれかの状態コードを返します。

リターン コード 形容
STATUS_INVALID_PARAMETER Argument1 が NULL であるか、Argument2 が NULL であるか、HwInitializationData が NULL します。
STATUS_SUCCESS ドライバー拡張機能のデータとアダプター情報が正常に初期化されました。
STATUS_NO_MEMORY 初期化パラメーターを格納するために使用できるメモリはありません。
STATUS_REVISION_MISMATCH HwInitializationData が指す構造体のバージョンは、現在のオペレーティング システムでは無効です。
STATUS_INSUFFICENT_RESOURCES ドライバー オブジェクト拡張データの割り当てに失敗しました。

備考

このルーチンは、ミニポート ドライバーの DriverEntry ルーチンから呼び出す必要があります。

Storport ミニポート ドライバーは PnP をサポートする必要があるため、Storport ドライバーは、StorPortInitializeに渡される HwContext パラメーター 使用しません。

すべてのミニポート ドライバーの DriverEntry ルーチンは、ミニポート ドライバーが最初に 0 になった後、HW_INITIALIZATION_DATAのメンバーを設定した後 StorPortInitialize を呼び出す必要があります。

必要条件

要件 価値
ターゲット プラットフォーム の 万国
ヘッダー storport.h (Storport.h を含む)
ライブラリ Storport.lib

関連項目

HW_INITIALIZATION_DATA

HwStorFindAdapter の