StorPortValidateRange routine

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.

Syntax


STORPORT_API BOOLEAN StorPortValidateRange(
  _In_ PVOID                 HwDeviceExtension,
  _In_ INTERFACE_TYPE        BusType,
  _In_ ULONG                 SystemToBusNumber,
  _In_ STOR_PHYSICAL_ADDRESS IoAddress,
  _In_ ULONG                 NumberOfBytes,
  _In_ BOOLEAN               InIoSpace
);

Parameters

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.

SystemToBusNumber [in]

Contains 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.

Return value

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.

Remarks

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.

Requirements

Target platform

Universal

Header

Storport.h (include Storport.h)

Library

Storport.lib

DDI compliance rules

StorPortDeprecated

See also

ScsiPortValidateRange

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft