ScsiPortFreeDeviceBase-Funktion (srb.h)

Artikel
02/29/2024

Die ScsiPortFreeDeviceBase-Routine gibt einen Bereich von Geräte-E/A- oder Speicherspeicheradressen frei, die zuvor mit ScsiPortGetDeviceBase dem Systemadressraum zugeordnet wurden.

Hinweis Der SCSI-Porttreiber und die SCSI-Miniporttreibermodelle 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

SCSIPORT_API VOID ScsiPortFreeDeviceBase(
  [in] PVOID HwDeviceExtension,
  [in] PVOID MappedAddress
);

Parameter

[in] HwDeviceExtension

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

[in] MappedAddress

Zeiger auf die Basisadresse des zu befreienden Bereichs. Diese Adresse muss mit der adresse identisch sein, die von ScsiPortGetDeviceBase zurückgegeben wird.

Rückgabewert

Keine

Bemerkungen

Wenn die HwScsiFindAdapter-Routine eines Miniporttreibers feststellt, dass der Treiber keine bestimmte zugeordnete Basisadresse für einen Adapter benötigt, muss er die Zuordnung durch Aufrufen dieser Routine freigeben. Wenn ein Miniporttreiber beispielsweise feststellt, dass auf einem bestimmten E/A-Bus keine unterstützten HBAs vorhanden sind, muss er ScsiPortFreeDeviceBase mit jeder zugeordneten Adresse aufrufen, die von ScsiPortGetDeviceBase zurückgegeben wird, wenn Aufrufe dieser Routine getätigt wurden.

ScsiPortFreeDeviceBase kann nur aus der HwScsiFindAdapter-Routine des Miniporttreibers aufgerufen werden. Anrufe von anderen Miniporttreiberroutinen führen zu Systemfehlern oder zu einem falschen Betrieb für den Aufrufer.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	srb.h (einschließlich Miniport.h, Scsi.h)
Bibliothek	Scsiport.lib

Weitere Informationen

HwScsiFindAdapter

ScsiPortGetDeviceBase

Freigeben über