共用方式為

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，例如 Isa 和 MicroChannel 類型 I/O 總線，迷你埠驅動程式應該針對每個支援的介面類型呼叫 ScsiPortInitialize 。

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

規格需求

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

另請參閱

SCSI 迷你埠驅動程式的 DriverEntry

HW_INITIALIZATION_DATA (SCSI)

HwScsiFindAdapter