StorPortInitialize-Funktion (storport.h)

Die StorPortInitialize-Routine initialisiert die Porttreiberparameter und Erweiterungsdaten. StorPortInitialize speichert auch die Adapterinformationen, die aus der DriverEntry-Routine des Miniporttreibers bereitgestellt werden.

Syntax

STORPORT_API ULONG StorPortInitialize(
  [in]           PVOID                   Argument1,
  [in]           PVOID                   Argument2,
  [in]           _HW_INITIALIZATION_DATA *HwInitializationData,
  [in, optional] PVOID                   HwContext
);

Parameter

[in] Argument1

Der erste Zeiger, mit dem das Betriebssystem die DriverEntry-Routine des Miniports aufgerufen hat.

[in] Argument2

Der zweite Zeiger, mit dem das Betriebssystem die DriverEntry-Routine der Miniports aufgerufen hat.

[in] HwInitializationData

Zeiger auf die Initialisierungs- und Konfigurationsinformationen, die vom Miniporttreiber in seiner DriverEntry-Routine festgelegt wurden.

[in, optional] HwContext

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

Rückgabewert

Das Ergebnis der Initialisierungsaktionen, die von StorPortInitialize ausgeführt werden. Der Miniporttreiber gibt diesen Wert als Rückgabewert für seine DriverEntry-Routine zurück.

StorPortInitialize gibt einen der folgenden status Codes zurück:

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER	Argument1 ist NULL, oder Argument2 IST NULL, ODER HwInitializationData ist NULL.
STATUS_SUCCESS	Die Treibererweiterungsdaten und Adapterinformationen wurden erfolgreich initialisiert.
STATUS_NO_MEMORY	Zum Speichern eines Initialisierungsparameters steht kein Arbeitsspeicher zur Verfügung.
STATUS_REVISION_MISMATCH	Die Version der Struktur, auf die von HwInitializationData verwiesen wird, ist für das aktuelle Betriebssystem ungültig.
STATUS_INSUFFICENT_RESOURCES	Fehler bei der Zuordnung für die Treiberobjekterweiterungsdaten.

Hinweise

Diese Routine muss von der DriverEntry-Routine des Miniporttreibers aufgerufen werden.

Da Storport-Miniporttreiber PnP unterstützen müssen, verwendet der Storport-Treiber nicht den an StorPortInitialize übergebenen HwContext-Parameter.

Die DriverEntry-Routine jedes Miniporttreibers muss StorPortInitialize aufrufen, nachdem der Miniporttreiber zuerst auf null gesetzt wurde, und dann die Member von HW_INITIALIZATION_DATA festlegen.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
Header	storport.h (einschließlich Storport.h)
Bibliothek	Storport.lib

Weitere Informationen

HW_INITIALIZATION_DATA

HwStorFindAdapter