ScsiPortGetVirtualAddress 函式 (srb.h)
如果實體位址是透過呼叫 ScsiPortGetPhysicalAddress 來取得,ScsiPortGetVirtualAddress 例程會傳回與實體地址相關聯的虛擬位址。
注意 SCSI 埠驅動程式和 SCSI 迷你埠驅動程式模型未來可能會改變或無法使用。 相反地,我們建議使用 Storport 驅動程式 和 Storport 迷你埠 驅動程式模型。
語法
SCSIPORT_API PVOID ScsiPortGetVirtualAddress(
[in] PVOID HwDeviceExtension,
[in] SCSI_PHYSICAL_ADDRESS PhysicalAddress
);
參數
[in] HwDeviceExtension
硬體裝置擴充功能的指標。 這是埠驅動程式代表迷你埠驅動程式配置和初始化的每個 HBA 儲存區域。 迷你埠驅動程式通常會在此延伸模組中儲存 HBA 特定資訊,例如 HBA 的狀態和 HBA 的對應存取範圍。 此區域可在迷你埠驅動程式呼叫 ScsiPortInitialize 之後,立即提供給 HBA 裝置物件的 DeviceExtension-HwDeviceExtension> 成員。 埠驅動程式會在移除裝置時釋放此記憶體。
[in] PhysicalAddress
指定要對應的實體位址。 此值必須由 ScsiPortGetPhysicalAddress 傳回,而且必須來自未快取的裝置擴充功能或 SRB 擴充功能。
傳回值
ScsiPortGetVirtualAddress 會傳回指定輸入地址的對應指標。 如果 PhysicalAddress 值無效,則會傳回 NULL。
備註
ScsiPortGetVirtualAddress 會使用 SCSI_PHYSICAL_ADDRESS 來代表實體位址。
typedef PHYSICAL_ADDRESS SCSI_PHYSICAL_ADDRESS, *PSCSI_PHYSICAL_ADDRESS;
SCSI_PHYSICAL_ADDRESS類型是與操作系統無關的數據類型,SCSI 迷你埠驅動程式會用來代表實體位址或總線相對位址。
注意 SCSI 埠驅動程式和 SCSI 迷你埠驅動程式模型未來可能會改變或無法使用。 相反地,我們建議使用 Storport 驅動程式 和 Storport 迷你埠 驅動程式模型。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | srb.h (包括 Miniport.h、Scsi.h) |
程式庫 | Scsiport.lib |