PEP_REQUEST_COMPONENT_PERF_STATE Struktur (pep_x.h)

Artikel
02/07/2025

Die PEP_REQUEST_COMPONENT_PERF_STATE-Struktur enthält eine Liste der Vom Windows Power Management Framework (PoFx) angeforderten Änderungen des Leistungszustands (P-State) sowie Statusinformationen zur Behandlung dieser Anforderungen durch das Plattformerweiterungs-Plug-In (PEP).

Syntax

typedef struct _PEP_REQUEST_COMPONENT_PERF_STATE {
  [in]  PEPHANDLE                         DeviceHandle;
  [in]  ULONG                             Component;
  [out] BOOLEAN                           Completed;
  [out] BOOLEAN                           Succeeded;
  [in]  ULONG                             PerfRequestsCount;
  [in]  PPEP_COMPONENT_PERF_STATE_REQUEST PerfRequests;
} PEP_REQUEST_COMPONENT_PERF_STATE, *PPEP_REQUEST_COMPONENT_PERF_STATE;

Angehörige

[in] DeviceHandle

Ein PEPHANDLE-Wert, der das Gerät identifiziert. Der PEP hat dieses Handle als Reaktion auf eine vorherige PEP_DPM_REGISTER_DEVICE Benachrichtigung bereitgestellt.

[in] Component

Der Index, der die Komponente identifiziert. Dieses Element ist ein Index im Components Array in der PEP_DEVICE_REGISTER_V2 Struktur, die der PEP zuvor als Reaktion auf die PEP_DPM_REGISTER_DEVICE-Benachrichtigung für dieses Gerät bereitgestellt hat. Wenn das Components Array N-Elemente enthält, reichen Komponentenindizes von 0 bis N-1.

[out] Completed

Gibt an, ob der PEP die angeforderten P-Zustandsänderungen abgeschlossen hat. Auf TRUE festgelegt, um anzugeben, dass die P-Zustandsänderungen synchron abgeschlossen wurden. Auf FALSE festgelegt, um anzugeben, dass die angeforderten P-Zustandsänderungen ausstehen und asynchron von einem PEP-Workerthread abgeschlossen werden. Weitere Informationen finden Sie in den Hinweisen.

[out] Succeeded

Gibt an, ob die angeforderten P-Zustandsänderungen erfolgreich abgeschlossen wurden. Auf TRUE festgelegt, wenn die PEP alle P-Zustandsänderungen erfolgreich abgeschlossen hat, die im PerfRequests Array angefordert wurden. Auf FALSE festgelegt, wenn der PEP nicht alle angeforderten P-Zustandsänderungen ausführen konnte, in diesem Fall bleiben die P-Zustände in der Hardware unverändert. Das Mitglied "Erfolgreich" wird nur für synchronen P-Zustandsänderungen verwendet. Wenn der PEP Completed auf FALSE festlegt, ignoriert PoFx den Wert im Erfolgreich Member.

[in] PerfRequestsCount

Die Anzahl der im Array angeforderten P-Zustandsänderungen, auf die das PerfRequests Member verweist.

[in] PerfRequests

Ein Zeiger auf ein Array von PEP_COMPONENT_PERF_STATE_REQUEST Strukturen. Jedes Element im Array gibt eine neue Leistungsstufe an, die einem P-Zustandssatz zugewiesen werden soll. Die Anzahl der Arrayelemente wird durch das PerfRequestsCount Member angegeben.

Bemerkungen

Diese Struktur wird von der PEP_DPM_REQUEST_COMPONENT_PERF_STATE Benachrichtigung verwendet. Die DeviceHandle, Component, PerfRequestsCountund PerfRequests Elemente der Struktur enthalten Eingabewerte, die von PoFx beim Senden dieser Benachrichtigung bereitgestellt werden. Die Abgeschlossene und Erfolgreich Member enthalten Ausgabewerte, die der PEP als Reaktion auf die Benachrichtigung in die Struktur schreibt.

Der PEP kann die angeforderten P-Zustandsänderungen entweder synchron oder asynchron abschließen. Der PEP kann den Completed Member auf TRUE festlegen, um anzugeben, dass alle Anforderungen in der PEP_DPM_REQUEST_COMPONENT_PERF_STATE-Benachrichtigung synchron abgeschlossen wurden, d. h. bevor die Rückgabe der AcceptDeviceNotification Rückrufroutine von PEP zurückgegeben wird. Oder der PEP kann Completed auf FALSE festlegen, um anzugeben, dass die Anforderungen asynchron abgeschlossen werden. Um die Anforderungen asynchron abzuschließen, sollte der PEP die RequestWorker Routine aufrufen, um PoFx darüber zu informieren, dass der PEP über eine Arbeitsanforderung zum Übermitteln verfügt, und PoFx antwortet, indem eine PEP_DPM_WORK Benachrichtigung an den PEP gesendet wird.

PoFx schreibt die angeforderten P-Zustandsänderungen in das PerfRequests Array, bevor die PEP_DPM_REQUEST_COMPONENT_PERF_STATE Benachrichtigung gesendet wird. Wenn der PEP die angeforderten P-Zustandsänderungen synchronverarbeitet, bleiben die Inhalte der PerfRequests Array nur gültig, bis die Rückgabe aus der AcceptDeviceNotification Rückrufroutine. Wenn die Anforderungen asynchronabgeschlossen werden, bleiben die Arrayinhalte gültig, bis der PEP die CompleteWork Routine aufruft, um PoFx zu benachrichtigen, dass der PEP die ausstehenden Anforderungen abgeschlossen hat.