StorPortValidateRange - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// storport.h
STORPORT_API BOOLEAN StorPortValidateRange(
[in] PVOID HwDeviceExtension,
[in] INTERFACE_TYPE BusType,
ULONG SystemIoBusNumber,
[in] STOR_PHYSICAL_ADDRESS IoAddress,
[in] ULONG NumberOfBytes,
[in] BOOLEAN InIoSpace
);
View the official Windows Driver Kit DDI referenceNo description available.
The StorPortValidateRange routine determines whether a specified range of I/O addresses is in use by another adapter. This routine is obsolete in Windows NT 4.0 and later operating systems.
HwDeviceExtension [in]A pointer to the hardware device extension. This is a per HBA storage area that the port driver allocates and initializes on behalf of the miniport driver. Miniport drivers usually store HBA-specific information in this extension, such as the state of the HBA and the mapped access ranges for the HBA. This area is available to the miniport driver immediately after the miniport driver calls StorPortInitialize. The port driver frees this memory when it removes the device.
BusType [in]Contains a value of type STORAGE_BUS_TYPE that indicates the bus type.
SystemIoBusNumberContains an integer identifying a system bus.
IoAddress [in]Contains the beginning address of the range of addresses to be validated.
NumberOfBytes [in]Contains the length in bytes of the range of addresses to be validated.
InIoSpace [in]Indicates, when TRUE, that the address range is in I/O space. If FALSE, the address is in memory space.
StorPortValidateRange returns TRUE if a specified range of addresses is not claimed by another driver. This routine returns FALSE if another driver has claimed the address range.
For compatibility with older versions of Windows, this routine always returns TRUE.
Miniport drivers are given valid I/O ranges in the AccessRanges member of the PORT_CONFIGURATION_INFORMATION structure when the Storport driver calls the miniport's HwStorFindAdapter callback routine.
StorPortValidateRange uses STOR_PHYSICAL_ADDRESS to represent bus-relative addresses.
typedef PHYSICAL_ADDRESS STOR_PHYSICAL_ADDRESS, *PSTOR_PHYSICAL_ADDRESS;
The STOR_PHYSICAL_ADDRESS type is an operating system-independent data type that Storport miniport drivers use to represent either a physical addresses or a bus-relative address.