共用方式為


ScsiPortFreeDeviceBase 函式 (srb.h)

ScsiPortFreeDeviceBase 例程會釋放先前對應到系統地址空間的裝置 I/O 或記憶體空間位址範圍,ScsiPortGetDeviceBase

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

語法

SCSIPORT_API VOID ScsiPortFreeDeviceBase(
  [in] PVOID HwDeviceExtension,
  [in] PVOID MappedAddress
);

參數

[in] HwDeviceExtension

硬體裝置延伸模組的指標。 這是埠驅動程式代表迷你埠驅動程式配置和初始化的每個 HBA 儲存區域。 迷你埠驅動程式通常會在此延伸模組中儲存 HBA 特定資訊,例如 HBA 的狀態和 HBA 的對應存取範圍。 在迷你埠驅動程式呼叫 ScsiPortInitialize之後,此區域可供 DeviceExtension->HwDeviceExtension HBA 裝置對象的成員使用。 埠驅動程式會在移除裝置時釋放此記憶體。

[in] MappedAddress

要釋放之範圍的基位址指標。 此地址必須與 ScsiPortGetDeviceBase所傳回的位址相同。

傳回值

沒有

言論

如果迷你埠驅動程式的 HwScsiFindAdapter 例程判斷驅動程式不需要適配卡的特定對應基位址,則必須呼叫此例程來釋放對應。 例如,當迷你埠驅動程序判斷特定 I/O 總線上沒有支援的 HBA 時,它必須呼叫 ScsiPortFreeDeviceBase,且每個對應位址都是由 ScsiPortGetDeviceBase所傳回,如果已呼叫此例程。

ScsiPortFreeDeviceBase 只能從迷你埠驅動程式的 HwScsiFindAdapter 例程呼叫。 來自其他迷你埠驅動程式例程的呼叫會導致系統失敗或呼叫端的作業不正確。

要求

要求 價值
目標平臺 桌面
標頭 srb.h (include Miniport.h, Scsi.h)
連結庫 Scsiport.lib

另請參閱

HwScsiFindAdapter

ScsiPortGetDeviceBase