StorPortPoFxSetPerfState-Funktion (storport.h)

StorPortPoFxSetPerfState legt den P-Zustand einer Komponente fest (Leistungs- oder Perf-Zustand).

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, daher muss Address NULL sein.

Component

Der Index, der die Komponente identifiziert, deren P-Zustände verwaltet werden. Dieser Parameter ist ein Index für das Componentsarray 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, liegen die Komponentenindizes zwischen 0 und N–1.

Flags

Derzeit muss auf NULL festgelegt werden.

SetIndex

Der Index eines zuvor registrierten Perf-Satzes.

State

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

Context

Ein beliebiger Kontext, der an den Änderungsrückruf des perf-Satzes übergeben wird.

Rückgabewert

StorPortPoFxSetPerfState gibt STOR_STATUS_SUCCESS nach erfolgreichem Abschluss oder wenn die Laufzeitleistung deaktiviert wurde, oder einen Fehlercode wie einen der folgenden zurück:

Fehlercode	Bedeutung
STOR_STATUS_INVALID_PARAMETER	Einer der Parameter ist ungültig. Beispielsweise sind Address oder Flags nicht NULL.
STOR_STATUS_UNSUCCESSFUL	Der Adapter ist nicht für die Erkennung im Leerlauf registriert.

Anforderungen

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