ScsiPortInitialize-Funktion (srb.h)

Artikel
02/07/2025

Bei einem Nicht-Plug- und 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- und Play-Miniporttreiber speichert ScsiPortInitialize die Initialisierungsdaten des Miniporttreibers für die zukünftige Verwendung.

Hinweis Der SCSI-Porttreiber und die SCSI-Miniporttreibermodelle können in Zukunft geändert oder nicht mehr verfügbar sein. Stattdessen empfehlen wir die Verwendung des Storport-Treibers und Storport Miniport Treibermodelle.

Syntax

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

Parameter

[in] Argument1

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

[in] Argument2

Zeigen Sie auf einige Kontextinformationen, die das Betriebssystem im zweiten Argument des DriverEntryan den Miniporttreiber übergeben hat.

[in] HwInitializationData

Zeiger auf die Initialisierungs- und Konfigurationsinformationen, die von DriverEntrybereitgestellt werden.

[in] HwContext

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

Rückgabewert

ScsiPortInitialize gibt einen Statuswert zurück, der als Rückgabewert der DriverEntry Routine des Miniporttreibers verwendet wird.

Bemerkungen

Jede DriverEntry- Routine des 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. Isa und MicroChannel Typ-E/A-Busse, 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 Aufrufe speichern. Die DriverEntry Routine muss den niedrigsten Wert zurückgeben, wenn sie die Steuerung an das System zurückgibt. Miniport-Treiberautoren können keine Annahmen über die von ScsiPortInitializezurückgegebenen Werte machen.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	srb.h (include Miniport.h, Scsi.h)
Library	Scsiport.lib

Siehe auch

DriverEntry des SCSI-Miniporttreibers

HW_INITIALIZATION_DATA (SCSI)-

HwScsiFindAdapter-

Freigeben über