StorPortInitializePerfOpts-Funktion (storport.h)

Artikel
02/26/2024

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

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 Host Bus Adapter (HBA). Dieser Parameter darf nicht NULL sein.

[in] Query

Wenn auf TRUE festgelegt ist, legt Storport die Flags in PerfConfigData fest, die den von Storport unterstützten Optimierungen entsprechen. Wenn 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 status Werte zurück:

Rückgabecode	Beschreibung
STOR_STATUS_NOT_IMPLEMENTED	Diese Funktion ist auf dem aktiven Betriebssystem nicht implementiert.
STOR_STATUS_SUCCESS	Gibt an, dass die Leistungsoptimierungseinstellungen angewendet wurden. Wenn Query auf TRUE festgelegt ist, enthält das Flags-Element der Struktur, auf die perfConfigData verweist, die unterstützten Flags.
STOR_STATUS_UNSUCCESSFUL	Der Miniporttreiber hat in PerfConfigData ein Flag festgelegt, das Storport nicht erkannt hat, oder der Miniporttreiber hat diese Routine von 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.

Hinweise

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

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

Anforderungen

Anforderung	Wert
Zielplattform	Universell
Header	storport.h (einschließlich Storport.h)
DDI-Complianceregeln	StorPortPerfOpts(storport)

Weitere Informationen

PERF_CONFIGURATION_DATA

Freigeben über