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 例程的第二個指標。

[in] HwInitializationData

迷你埠驅動程式在其 DriverEntry 例程中設定之初始化和組態資訊的指標。

[in, optional] HwContext

這是要傳遞至迷你埠驅動程式 HwStorFindAdapter 例程的內容值位址。 只有掃描總線上 HBA 的舊版迷你埠驅動程式，而不是從埠驅動程式接收組態資訊，才能使用此參數來儲存 對 HwStorFindAdapter 呼叫之間的狀態。

傳回值

StorPortInitialize 所執行初始化動作的結果。 迷你埠驅動程式會傳回此值作為其 DriverEntry 例程的傳回值。

StorPortInitialize 會傳回下列其中一個狀態代碼：

傳回碼 Description
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的成員。

規格需求

需求 值
目標平台 Universal
標頭 storport.h (包含 Storport.h)
程式庫 Storport.lib

另請參閱

HW_INITIALIZATION_DATA

HwStorFindAdapter