StorPortValidateRange-Funktion (storport.h)

Artikel
02/07/2025

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. Dies ist ein HBA-Speicherbereich, den der Porttreiber im Namen des Miniporttreibers zuweist und initialisiert. Miniporttreiber speichern in der Regel HBA-spezifische Informationen in dieser Erweiterung, z. B. den Zustand der HBA und die zugeordneten Zugriffsbereiche für die HBA. Dieser Bereich steht dem Miniporttreiber unmittelbar nach dem Aufruf des Miniporttreibers StorPortInitializezur Verfügung. Der Porttreiber gibt diesen Speicher frei, wenn es 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 zu überprüfenden Adressbereichs.

[in] NumberOfBytes

Enthält die Länge in Byte des zu überprüfenden Adressbereichs.

[in] InIoSpace

Gibt an, wenn TRUE, dass sich der Adressbereich im E/A-Leerzeichen befindet. Wenn FALSE-, befindet sich die Adresse im Arbeitsspeicher.

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.

Bemerkungen

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

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

StorPortValidateRange verwendet STOR_PHYSICAL_ADDRESS, um busrelative Adressen darzustellen.

typedef PHYSICAL_ADDRESS STOR_PHYSICAL_ADDRESS, *PSTOR_PHYSICAL_ADDRESS;

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

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Header-	storport.h (include Storport.h)
Library	Storport.lib
DDI-Complianceregeln	StorPortDeprecated(storport)

Siehe auch

ScsiPortValidateRange

Freigeben über