Freigeben über

StorPortPoFxSetPerfState-Funktion (storport.h)

  • Artikel

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 geräts, das registriert wird. Derzeit werden nur Adapter unterstützt, sodass Adresse NULL sein muss.

Component

Der Index, der die Komponente identifiziert, deren P-Zustände verwaltet werden. Dieser Parameter ist ein Index im ComponentsArrays in der STOR_POFX_DEVICE Struktur, die der Miniport zum Registrieren des Geräts für die Storport PoFx-Unterstützung verwendet hat. Wenn das Components Array 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 Satz perf 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 erfolgreichem Abschluss STOR_STATUS_SUCCESS zurück oder wenn die Laufzeitleistung deaktiviert wurde, oder ein Fehlercode wie einer der folgenden:

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

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 8
Header- storport.h