AtaPortGetDeviceBase-Funktion (irb.h)

Artikel
02/26/2024

Die AtaPortGetDeviceBase-Routine gibt eine zugeordnete logische Basisadresse zurück, die für die Kommunikation mit einem HBA verwendet wird.

Hinweis Die Modelle ATA-Porttreiber und ATA-Miniporttreiber können in Zukunft geändert oder nicht mehr verfügbar sein. Stattdessen wird empfohlen, die Modelle Storport-Treiber und Storport-Miniporttreiber zu verwenden.

Syntax

PVOID AtaPortGetDeviceBase(
  [in] PVOID                ChannelExtension,
  [in] IDE_PHYSICAL_ADDRESS IoAddress,
  [in] ULONG                NumberOfBytes
);

Parameter

[in] ChannelExtension

Ein Zeiger auf die Kanalerweiterung.

[in] IoAddress

Gibt die zuzuordnende Basisadresse an.

[in] NumberOfBytes

Gibt die Größe des Bereichs in Bytes an, den die Zuordnungen abdecken sollen. Der Wert für diesen Parameter kann aus dem IdeAccessRange-Member der IDE_MINIPORT_RESOURCES-Struktur abgerufen werden.

Rückgabewert

AtaPortGetDeviceBase gibt eine zugeordnete logische Basisadresse zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird NULL zurückgegeben.

Hinweise

Miniporttreiber müssen logische Adressen verwenden, die von AtaPortGetDeviceBase dem Systemraum zugeordnet wurden, anstelle von busrelativen Adressen, um mit dem HBA zu kommunizieren. Anrufe an den AtaPort... Port-/Register-Xxx-Routinen erfordern zugeordnete logische Adressen.