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)

另請參閱

ScsiPortValidateRange