ScsiPortInitialize-Funktion (srb.h)

Artikel
02/26/2024

Für einen Nicht-Plug & Play Miniporttreiber richtet die ScsiPortInitialize-Routine die PORT_CONFIGURATION_INFORMATION-Struktur ein und ruft die HwScsiFindAdapter-Routine des Miniporttreibers auf. ScsiPortInitialize richtet auch Systemobjekte und Ressourcen im Namen von Miniporttreibern ein. Für einen Plug & Play Miniporttreiber speichert ScsiPortInitialize die Initialisierungsdaten des Miniporttreibers für die zukünftige Verwendung.

Hinweis Der SCSI-Porttreiber und die SCSI-Miniporttreibermodelle sind möglicherweise geändert oder in Zukunft nicht mehr verfügbar. Stattdessen wird empfohlen, die Modelle Storport-Treiber und Storport-Miniporttreiber zu verwenden.

Syntax

SCSIPORT_API ULONG ScsiPortInitialize(
  [in] PVOID                   Argument1,
  [in] PVOID                   Argument2,
  [in] _HW_INITIALIZATION_DATA *HwInitializationData,
  [in] PVOID                   HwContext
);

Parameter

[in] Argument1

Zeiger auf das Treiberobjekt, das das Betriebssystem im ersten Argument seiner DriverEntry-Routine an den Miniporttreiber übergeben hat.

[in] Argument2

Zeiger auf einige Kontextinformationen, die das Betriebssystem im zweiten Argument seines DriverEntry an den Miniporttreiber übergeben hat.

[in] HwInitializationData

Zeiger auf die von DriverEntry bereitgestellten Initialisierungs- und Konfigurationsinformationen.

[in] HwContext

Gibt die Adresse eines Kontextwerts an, der an die HwScsiFindAdapter-Routine des Miniporttreibers übergeben werden soll. Nur ältere Miniporttreiber, die den Bus auf HBAs überprüfen, anstatt Konfigurationsinformationen vom Porttreiber zu empfangen, können diesen Parameter verwenden, um den Zustand zwischen Aufrufen von HwScsiFindAdapter zu speichern.

Rückgabewert

ScsiPortInitialize gibt einen status Wert zurück, der als Rückgabewert aus der DriverEntry-Routine des Miniporttreibers verwendet wird.

Hinweise

Die DriverEntry-Routine jedes Miniporttreibers muss ScsiPortInitialize aufrufen, nachdem der Miniporttreiber zuerst null gesetzt und dann den HW_INITIALIZATION_DATA eingerichtet hat.

Wenn ein Miniporttreiber HBAs für verschiedene Typen von E/A-Bussen unterstützen kann, z. B. I/O-Busse vom Typ Isa und MicroChannel , sollte der Miniporttreiber ScsiPortInitialize für jeden unterstützten Schnittstellentyp aufrufen.

Ein Miniporttreiber, der ScsiPortInitialize mehrmals aufruft, sollte den von ScsiPortInitialize bei jedem Aufruf zurückgegebenen Wert überprüfen und den niedrigsten Wert für alle Seine Aufrufe speichern. Die DriverEntry-Routine muss den niedrigsten Wert zurückgeben, wenn sie die Steuerung an das System zurückgibt. Miniport-Treiberschreiber können keine Annahmen über die von ScsiPortInitialize zurückgegebenen Werte treffen.

Anforderungen

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

Weitere Informationen

DriverEntry of SCSI Miniport Driver

HW_INITIALIZATION_DATA (SCSI)

HwScsiFindAdapter

Freigeben über