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 的 PORT_CONFIGURATION_INFORMATIONHwStorFindAdapter 例程時,Miniport 驅動程式會在 AccessRanges 成員中提供有效的 I/O 範圍。
StorPortValidateRange 會使用 STOR_PHYSICAL_ADDRESS 來表示總線相對位址。
typedef PHYSICAL_ADDRESS STOR_PHYSICAL_ADDRESS, *PSTOR_PHYSICAL_ADDRESS;
STOR_PHYSICAL_ADDRESS 類型是與作系統無關的數據類型,Storport 迷你埠驅動程式用來代表實體位址或總線相對位址。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | storport.h (包括 Storport.h) |
連結庫 | Storport.lib |
DDI 合規性規則 | StorPortDeprecated(storport) |