ScsiPortInitialize 函式 (srb.h)

針對非隨插即用迷你埠驅動程式,ScsiPortInitialize常式會設定PORT_CONFIGURATION_INFORMATION結構,並呼叫迷你埠驅動程式的HwScsiFindAdapter常式。 ScsiPortInitialize 也會代表迷你埠驅動程式設定系統物件和資源。 對於隨插即用迷你埠驅動程式,ScsiPortInitialize會儲存迷你埠驅動程式的初始化資料以供日後使用。

注意 未來可能會變更或無法使用 SCSI 埠驅動程式和 SCSI 迷你埠驅動程式模型。 相反地,我們建議使用 Storport 驅動程式Storport 迷你埠 驅動程式模型。
 

語法

SCSIPORT_API ULONG ScsiPortInitialize(
  [in] PVOID                   Argument1,
  [in] PVOID                   Argument2,
  [in] _HW_INITIALIZATION_DATA *HwInitializationData,
  [in] PVOID                   HwContext
);

參數

[in] Argument1

作業系統在其 DriverEntry 常式的第一個引數中傳遞至迷你埠驅動程式的驅動程式物件的指標。

[in] Argument2

作業系統在其 DriverEntry的第二個引數中傳遞至迷你埠驅動程式的一些內容資訊指標。

[in] HwInitializationData

DriverEntry所提供的初始化和組態資訊的指標。

[in] HwContext

指定要傳遞至迷你埠驅動程式 HwScsiFindAdapter 常式的內容值位址。 只有掃描匯流排是否有 HBA 的舊版迷你埠驅動程式,而不是從埠驅動程式接收組態資訊,才能使用此參數來儲存 HwScsiFindAdapter呼叫之間的狀態。

傳回值

ScsiPortInitialize 會傳回狀態值,做為迷你埠驅動程式 DriverEntry 常式的傳回值。

備註

每個迷你埠驅動程式的 DriverEntry 常式都必須在迷你埠驅動程式先零後呼叫 ScsiPortInitialize ,然後設定HW_INITIALIZATION_DATA。

如果迷你埠驅動程式可以在不同類型的 I/O 匯流排上支援 HBA,例如 IsaMicroChannel 類型 I/O 匯流排,迷你埠驅動程式應該針對每個支援的介面類別型呼叫 ScsiPortInitialize

呼叫 ScsiPortInitialize 多次的迷你埠驅動程式應該在每個呼叫檢查 ScsiPortInitialize 所傳回的值,並儲存其所有呼叫的最低值。 DriverEntry常式在將控制權傳回給系統時,必須傳回最低值。 迷你埠驅動程式寫入器無法假設 ScsiPortInitialize所傳回的值。

規格需求

   
目標平臺 桌面
標頭 srb.h (包括 Miniport.h、Scsi.h)
程式庫 Scsiport.lib

另請參閱

SCSI 迷你埠驅動程式的 DriverEntry

HW_INITIALIZATION_DATA (SCSI)

HwScsiFindAdapter