StorPortPoFxSetPerfState-Funktion (storport.h)

StorPortPoFxSetPerfState legt den P-Zustand einer Komponente (Leistung oder "perf"-Zustand) fest.

Syntax

ULONG StorPortPoFxSetPerfState(
  PVOID         HwDeviceExtension,
  PSTOR_ADDRESS Address,
  ULONG         Component,
  ULONG         Flags,
  ULONG         SetIndex,
  ULONG         State,
  PVOID         Context
);

Parameter

HwDeviceExtension

Zeiger auf die Geräteerweiterung des Miniports.

Address

Adresse des registrierten Geräts. Derzeit werden nur Adapter unterstützt, daher muss die Adresse NULL sein.

Component

Der Index, der die Komponente identifiziert, deren P-Status verwaltet werden. Dieser Parameter ist ein Index in das Komponentenarrayin der STOR_POFX_DEVICE Struktur, die der Miniport zum Registrieren des Geräts für die Storport PoFx-Unterstützung verwendet hat. Wenn das Array "Components " N-Elemente enthält, reichen Komponentenindizes von 0 bis N–1.

Flags

Derzeit muss auf NULL festgelegt werden.

SetIndex

Der Index eines zuvor registrierten Perf-Satzes.

State

Wenn der Perf-Satz diskrete P-Zustände enthält, sollte dies ein Indexwert sein. Wenn der Perf-Satz ein Bereich ist, sollte dies ein Wert innerhalb dieses Bereichs sein.

Context

Ein beliebiger Kontext, der an den Perf-Set-Änderungsrückruf übergeben wird.

Rückgabewert

StorPortPoFxSetPerfState gibt nach erfolgreicher Fertigstellung STOR_STATUS_SUCCESS zurück oder wenn die Laufzeitleistung deaktiviert wurde, oder ein Fehlercode wie eine der folgenden:

Fehlercode Bedeutung
STOR_STATUS_INVALID_PARAMETER Einer der Parameter ist ungültig; Beispielsweise sind Adresse oder Flags nicht NULL.
STOR_STATUS_UNSUCCESSFUL Der Adapter ist nicht für die Leerlauferkennung registriert.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8
Header storport.h