StorPortInitializePerfOpts-Funktion (storport.h)

Die StorPortInitializePerfOpts-Funktion initialisiert die Leistungsoptimierungen, die sowohl der Miniporttreiber als auch die Storport-Treiberunterstützung mithilfe einer PERF_CONFIGURATION_DATA Struktur unterstützen.

Syntax

ULONG StorPortInitializePerfOpts(
  [in]      PVOID                    HwDeviceExtension,
  [in]      BOOLEAN                  Query,
  [in, out] PPERF_CONFIGURATION_DATA PerfConfigData
);

Parameter

[in] HwDeviceExtension

Ein Zeiger auf die Hardwaregeräteerweiterung für den Hostbusadapter (HBA). Dieser Parameter darf nicht NULL sein.

[in] Query

Wenn dieser Wert auf TRUE festgelegt ist, legt Storport die Flags in PerfConfigData fest, die den optimierungen Storport-Unterstützung entsprechen. Wenn " FALSE" festgelegt ist, initialisiert Storport die optimierungen, die durch die Flags in PerfConfigData angegeben werden.

[in, out] PerfConfigData

Ein Zeiger auf eine PERF_CONFIGURATION_DATA Struktur, die vom Miniporttreiber bereitgestellt wird. Dieser Parameter darf nicht NULL sein.

Rückgabewert

StorPortInitializePerfOpts gibt einen der folgenden Statuswerte zurück:

Rückgabecode Beschreibung
STOR_STATUS_NOT_IMPLEMENTED
Diese Funktion wird nicht auf dem aktiven Betriebssystem implementiert.
STOR_STATUS_SUCCESS
Gibt an, dass die Einstellungen für die Leistungsoptimierung angewendet wurden.

Oder wenn Die Abfrage auf TRUE festgelegt ist, enthält das Flags-Element der Struktur, auf die perfConfigData verweist, die unterstützten Flags.

STOR_STATUS_UNSUCCESSFUL
Der Miniport-Treiber legt ein Kennzeichen in PerfConfigData fest, das Storport nicht erkannt hat, oder der Miniporttreiber hat diese Routine außerhalb der vom Miniport-driver bereitgestellten HwStorInitialize-Routine aufgerufen.
STOR_STATUS_INSUFFICIENT_RESOURCES
Interne Strukturen können nicht zugewiesen werden, um die angeforderten Optimierungen zu unterstützen.
STOR_STATUS_INVALID_PARAMETER
Entweder der HwDeviceExtension-Parameter oder der PerfConfigData-Parameter war NULL.

Bemerkungen

Der Miniport-Treiber kann StorPortInitializePerfOpts nur während der miniport-bereitgestellten HwStorInitialize-Routine oder HwStorPassiveInitializeRoutine-Routine aufrufen.

Verfügbare Leistungsoptimierungen hängen von der Version von PERF_CONFIGURATION_DATA ab. Durch Festlegen des Versionsmitglieds auf STOR_PERF_VERSION können alle unterstützten Optimierungen ausgewählt werden.

Anforderungen

   
Zielplattform Universell
Header storport.h (include Storport.h)
DDI-Complianceregeln StorPortPerfOpts(storport)

Siehe auch

PERF_CONFIGURATION_DATA