StorPortValidateRange-Funktion (storport.h)

Die StorPortValidateRange-Routine bestimmt, ob ein angegebener Bereich von E/A-Adressen von einem anderen Adapter verwendet wird. Diese Routine ist in Windows NT 4.0 und höheren Betriebssystemen veraltet.

Syntax

STORPORT_API BOOLEAN StorPortValidateRange(
  [in] PVOID                 HwDeviceExtension,
  [in] INTERFACE_TYPE        BusType,
       ULONG                 SystemIoBusNumber,
  [in] STOR_PHYSICAL_ADDRESS IoAddress,
  [in] ULONG                 NumberOfBytes,
  [in] BOOLEAN               InIoSpace
);

Parameter

[in] HwDeviceExtension

Ein Zeiger auf die Hardwaregeräteerweiterung. Hierbei handelt es sich um einen HBA-Speicherbereich, den der Porttreiber im Auftrag des Miniporttreibers ordnet und initialisiert. Miniporttreiber speichern normalerweise HBA-spezifische Informationen in dieser Erweiterung, z. B. den Zustand des HBA und die zugeordneten Zugriffsbereiche für den HBA. Dieser Bereich steht dem Miniporttreiber unmittelbar nach dem Aufruf des Miniporttreibers StorPortInitialize zur Verfügung. Der Porttreiber gibt diesen Arbeitsspeicher frei, wenn er das Gerät entfernt.

[in] BusType

Enthält einen Wert vom Typ STORAGE_BUS_TYPE , der den Bustyp angibt.

SystemIoBusNumber

Enthält eine ganze Zahl, die einen Systembus identifiziert.

[in] IoAddress

Enthält die Anfangsadresse des Adressbereichs, der überprüft werden soll.

[in] NumberOfBytes

Enthält die Länge in Byte des Adressbereichs, der überprüft werden soll.

[in] InIoSpace

Gibt bei TRUE an, dass sich der Adressbereich im E/A-Bereich befindet. Bei FALSE befindet sich die Adresse im Speicherplatz.

Rückgabewert

StorPortValidateRange gibt TRUE zurück, wenn ein angegebener Adressbereich nicht von einem anderen Treiber beansprucht wird. Diese Routine gibt FALSE zurück, wenn ein anderer Treiber den Adressbereich beansprucht hat.

Hinweise

Aus Gründen der Kompatibilität mit älteren Versionen von Windows gibt diese Routine immer TRUE zurück.

Miniporttreiber erhalten gültige E/A-Bereiche im AccessRanges-Member der PORT_CONFIGURATION_INFORMATION-Struktur , wenn der Storport-Treiber die HwStorFindAdapter-Rückrufroutine des Miniports aufruft.

StorPortValidateRange verwendet STOR_PHYSICAL_ADDRESS , um busrelative Adressen darzustellen.

typedef PHYSICAL_ADDRESS STOR_PHYSICAL_ADDRESS, *PSTOR_PHYSICAL_ADDRESS;

Der STOR_PHYSICAL_ADDRESS Typs ist ein betriebssystemunabhängiger Datentyp, den Storport-Miniporttreiber verwenden, um entweder eine physische Adresse oder eine busrelative Adresse darzustellen.

Anforderungen

Weitere Informationen

ScsiPortValidateRange