ScsiPortFreeDeviceBase 函式 (srb.h)

  • 發行項

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

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

語法

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

參數

[in] HwDeviceExtension

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

[in] MappedAddress

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

傳回值

無

備註

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

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

規格需求

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

另請參閱

HwScsiFindAdapter

ScsiPortGetDeviceBase