共用方式為

StorPortInitialize 函式 （storport.h）

  • 發行項

StorPortInitialize 例程會初始化埠驅動程序參數和延伸模組數據。 StorPortInitialize 也會儲存從 miniport 驅動程式提供的配接器資訊，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 例程的第二個指標。

[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 例程都必須呼叫 StorPortInitialize 之後，迷你埠驅動程序必須先零，然後設定 HW_INITIALIZATION_DATA的成員。

要求

要求 價值
目標平臺 普遍
標頭 storport.h （包括 Storport.h）
連結庫 Storport.lib

另請參閱

HW_INITIALIZATION_DATA

HwStorFindAdapter