ScsiPortInitialize 函式 (srb.h)
對於非即插即用迷你埠驅動程式,ScsiPortInitialize 例程會設定PORT_CONFIGURATION_INFORMATION結構,並呼叫迷你埠驅動程式的 HwScsiFindAdapter 例程。 ScsiPortInitialize 也會代表迷你埠驅動程式設定系統對象和資源。 針對隨插即用迷你埠驅動程式,ScsiPortInitialize 儲存迷你埠驅動程式的初始化數據以供日後使用。
語法
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,例如 Isa 和 MicroChannel 類型 I/O 總線,迷你埠驅動程式應該為每個支援的介面類型呼叫 ScsiPortInitialize。
呼叫 ScsiPortInitialize 的迷你埠驅動程序應該檢查每個呼叫 ScsiPortInitial ize 所傳回的值,並儲存其所有呼叫的最低值。 DriverEntry 例程在將控件傳回給系統時,必須傳回最小值。 Miniport 驅動程式寫入器無法假設 ScsiPortInitialize 傳回的值,。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | srb.h (include Miniport.h, Scsi.h) |
連結庫 | Scsiport.lib |