StorPortValidateRange 函式 (storport.h)
StorPortValidateRange 例程會判斷另一個配接器是否正在使用指定的 I/O 位址範圍。 此例程在 Windows NT 4.0 和更新版本的作業系統中已過時。
語法
STORPORT_API BOOLEAN StorPortValidateRange(
[in] PVOID HwDeviceExtension,
[in] INTERFACE_TYPE BusType,
ULONG SystemIoBusNumber,
[in] STOR_PHYSICAL_ADDRESS IoAddress,
[in] ULONG NumberOfBytes,
[in] BOOLEAN InIoSpace
);
參數
[in] HwDeviceExtension
硬體裝置擴充功能的指標。 這是每個 HBA 儲存區域,埠驅動程式會代表迷你埠驅動程式配置和初始化。 迷你埠驅動程式通常會將此擴充功能中儲存 HBA 特定資訊,例如 HBA 的狀態和 HBA 的對應存取範圍。 此區域可在迷你埠驅動程式呼叫 StorPortInitialize 之後立即提供給迷你埠驅動程式。 埠驅動程式會在移除裝置時釋放此記憶體。
[in] BusType
包含 STORAGE_BUS_TYPE類型的 值,表示總線類型。
SystemIoBusNumber
包含識別系統總線的整數。
[in] IoAddress
包含要驗證之位址範圍的開頭位址。
[in] NumberOfBytes
包含要驗證之位址範圍的位元組長度。
[in] InIoSpace
表示當 為 TRUE 時,位址範圍在 I/O 空間中。 如果 為 FALSE,則地址位於記憶體空間中。
傳回值
如果另一個驅動程式未宣告指定的位址範圍,StorPortValidateRange 會傳回 TRUE。 如果另一個驅動程式已宣告位址範圍,此例程會傳回 FALSE 。
備註
為了與舊版 Windows 相容,此例程一律會傳回 TRUE。
當 Storport 驅動程式呼叫 miniport 的 HwStorFindAdapter 回呼例程時,會在 PORT_CONFIGURATION_INFORMATION 結構的 AccessRanges 成員中提供有效的 I/O 範圍。
StorPortValidateRange 會使用 STOR_PHYSICAL_ADDRESS 來代表總線相對位址。
typedef PHYSICAL_ADDRESS STOR_PHYSICAL_ADDRESS, *PSTOR_PHYSICAL_ADDRESS;
STOR_PHYSICAL_ADDRESS類型是與操作系統無關的數據類型,Storport 迷你埠驅動程式用來代表實體位址或總線相對位址。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
標頭 | storport.h (包含 Storport.h) |
程式庫 | Storport.lib |
DDI 合規性規則 | StorPortDeprecated (storport) |