StorPortInitializePerfOpts-Funktion (storport.h)

Artikel
02/07/2025

Die StorPortInitializePerfOpts Funktion initialisiert die Leistungsoptimierungen, die sowohl der Miniporttreiber als auch der Storport-Treiber 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 TRUEfestgelegt ist, legt Storport die Flags in PerfConfigData- fest, die den Optimierungen von Storport entsprechen. Wenn dieser Wert auf 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 ist nicht auf dem aktiven Betriebssystem implementiert.
STOR_STATUS_SUCCESS	Gibt an, dass die Einstellungen für die Leistungsoptimierung angewendet wurden. Oder wenn Abfrage- auf TRUEfestgelegt ist, enthält das Flags Element der Struktur, auf das PerfConfigData verweist, die unterstützten Flags.
STOR_STATUS_UNSUCCESSFUL	Der Miniport-Treiber legt eine Kennzeichnung in PerfConfigData fest, die Storport nicht erkannt hat, oder der Miniporttreiber hat diese Routine außerhalb der von miniport-driver bereitgestellten HwStorInitialize Routine aufgerufen.
STOR_STATUS_INSUFFICIENT_RESOURCES	Interne Strukturen können nicht zugeordnet werden, um die angeforderten Optimierungen zu unterstützen.
STOR_STATUS_INVALID_PARAMETER	Entweder der HwDeviceExtension Parameter oder der PerfConfigData Parameter war NULL.

Bemerkungen

Der Miniporttreiber kann StorPortInitializePerfOpts nur während der vom Miniport bereitgestellten HwStorInitialize Routine oder HwStorPassiveInitializeRoutine Routine aufrufen.

Verfügbare Leistungsoptimierungen hängen von der Version von PERF_CONFIGURATION_DATAab. Wenn Sie die Version Mitglied auf STOR_PERF_VERSION festlegen, können alle unterstützten Optimierungen ausgewählt werden.

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Header-	storport.h (include Storport.h)
DDI-Complianceregeln	StorPortPerfOpts(storport)

Siehe auch

PERF_CONFIGURATION_DATA

Freigeben über