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 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 Komponentenarray N-Elemente enthält, reichen die Komponentenindizes von 0 bis N–1.

Flags

Derzeit muss auf NULL festgelegt werden.

SetIndex

Der Index einer zuvor registrierten Perf-Gruppe.

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 Änderungsrückruf für den Perf-Satz übergeben wird.

Rückgabewert

StorPortPoFxSetPerfState gibt STOR_STATUS_SUCCESS zurück, wenn die Laufzeitleistung deaktiviert wurde, oder einen Fehlercode wie einen 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 Erkennung im Leerlauf registriert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8
Kopfzeile storport.h