StorPortInitialize-Funktion (storport.h)
Die StorPortInitialize Routine initialisiert die Parameter und Erweiterungsdaten des Porttreibers. StorPortInitialize speichert auch die Adapterinformationen, die vom MiniporttreiberDriverEntry Routine 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 genannt hat.
[in] Argument2
Der zweite Zeiger, mit dem das Betriebssystem die DriverEntry-Routine der Miniports bezeichnet.
[in] HwInitializationData
Zeiger auf die Initialisierungs- und Konfigurationsinformationen, die vom Miniporttreiber in der DriverEntry-Routine festgelegt wurden.
[in, optional] HwContext
Ist die Adresse eines Kontextwerts, der an die HwStorFindAdapter 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 HwStorFindAdapterzu speichern.
Rückgabewert
Das Ergebnis der Initialisierungsaktionen, die von StorPortInitializeausgeführt werden. Der Miniporttreiber gibt diesen Wert als Rückgabewert für die DriverEntry-Routine zurück.
StorPortInitialize gibt einen der folgenden Statuscodes zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_INVALID_PARAMETER | Argument1 NULL ist oder Argument2 NULL ist, ODER HwInitializationData NULL ist. |
| STATUS_SUCCESS | Die Treibererweiterungsdaten und Adapterinformationen wurden erfolgreich initialisiert. |
| STATUS_NO_MEMORY | Es ist kein Arbeitsspeicher verfügbar, um einen Initialisierungsparameter zu speichern. |
| STATUS_REVISION_MISMATCH | Die Version der Struktur, auf die von HwInitializationData verweist, ist für das aktuelle Betriebssystem ungültig. |
| STATUS_INSUFFICENT_RESOURCES | Fehler bei der Zuordnung für die Treiberobjekterweiterungsdaten. |
Bemerkungen
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 HwContext Parameter, der an StorPortInitializeübergeben wird.
Jede DriverEntry-Routine des Miniporttreibers muss StorPortInitialize aufrufen, nachdem der Miniporttreiber zuerst null gesetzt und dann die Member von HW_INITIALIZATION_DATAfestgelegt hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | storport.h (include Storport.h) |
| Library | Storport.lib |