ACCESS_RANGE-Struktur (storport.h)
Ein ACCESS_RANGE beschreibt einen Speicher- oder E/A-Portbereich, der von einem HBA verwendet wird.
Syntax
typedef struct _ACCESS_RANGE {
STOR_PHYSICAL_ADDRESS RangeStart;
ULONG RangeLength;
BOOLEAN RangeInMemory;
} ACCESS_RANGE, *PACCESS_RANGE;
Member
RangeStart
Enthält eine physische Adresse, die die busrelative Basisadresse eines vom HBA verwendeten Bereichs angibt. Der Wert dieses Members kann aus einem der AccessRanges-Elemente in der PORT_CONFIGURATION_INFORMATION-Struktur abgerufen werden. Dies ist eine Adresse, die an StorPortGetDeviceBase übergeben werden kann.
RangeLength
Gibt die Größe in Bytes oder die Anzahl der Ports im Bereich an. Ein Miniporttreiber muss sicherstellen, dass dieser Wert dem tatsächlich vom Adapter decodierten Bereich entspricht. Wenn der HBA beispielsweise sieben Register verwendet, aber auf acht antwortet, sollte dieser Member auf 8 festgelegt werden.
RangeInMemory
Gibt an, dass sich der Bereich im Arbeitsspeicher befindet, wenn true und nicht im E/A-Bereich vorhanden ist. Bei FALSE befindet sich der Bereich im E/A-Bereich.
Hinweise
Jede ACCESS_RANGE ist ein AccessRanges-Arrayelement innerhalb der PORT_CONFIGURATION_INFORMATION-Struktur , das an die HwStorFindAdapter-Routine eines Miniporttreibers übergeben wird.
Storport weist Arbeitsspeicher für die Zugriffsbereiche zu und initialisiert das AccessRanges-Element . Die HwStorFindAdapter-Routine des Miniport-Treibers sollte nur die angegebenen Adressen verwenden und niemals versuchen, andere HBAs auf demselben Bus zu finden, indem Sie adressen ihrer eigenen Entwicklung verwenden. Der Versuch, auf andere busrelative Ports oder Speicherbereiche zuzugreifen, wenn der Porttreiber Bereichsinformationen bereitgestellt hat, insbesondere in x86-only-Systemen, in denen einige Geräte im x86-Realmodus initialisiert werden, kann dazu führen, dass andere Geräte auf dem Bus die Initialisierung fehlschlagen oder sogar dazu führen, dass der Startvorgang des Systems fehlschlägt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | storport.h (include Srb.h, Storport.h, Strmini.h) |