PEP_REQUEST_COMPONENT_PERF_STATE-Struktur (pepfx.h)

Artikel
02/29/2024

Die PEP_REQUEST_COMPONENT_PERF_STATE-Struktur enthält eine Liste der vom Windows Power Management Framework (PoFx) angeforderten Änderungen des Leistungszustands (P-Zustand) sowie status Informationen 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;

Member

[in] DeviceHandle

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

[in] Component

Der Index, der die Komponente identifiziert. Dieser Member ist ein Index im Komponentenarray in der PEP_DEVICE_REGISTER_V2-Struktur , den pep zuvor als Reaktion auf die PEP_DPM_REGISTER_DEVICE-Benachrichtigung für dieses Gerät bereitgestellt hat. Wenn das Komponentenarray N-Elemente enthält, reichen die Komponentenindizes von 0 bis N–1.

[out] Completed

Gibt an, ob der PEP die angeforderten P-Zustandsänderungen abgeschlossen hat. Legen Sie diesen Wert auf TRUE fest, um anzugeben, dass sich der P-Zustand synchron ändert. Legen Sie diesen Wert auf FALSE fest, um anzugeben, dass die angeforderten P-Statusänderungen ausstehen und asynchron von einem PEP-Workerthread abgeschlossen werden. Weitere Informationen finden Sie in den Hinweisen.

[out] Succeeded

Gibt an, ob die angeforderte P-Zustandsänderung erfolgreich abgeschlossen wurde. Legen Sie diesen Wert auf TRUE fest, wenn pep alle im PerfRequests-Array angeforderten P-Zustandsänderungen erfolgreich abgeschlossen hat. Legen Sie diesen Wert auf FALSE fest, wenn pep nicht alle angeforderten P-Zustandsänderungen durchführen konnte. In diesem Fall wurden die P-Zustände in der Hardware unverändert gelassen. Der Succeeded-Member wird nur für synchrone P-Zustandsänderungen verwendet. Wenn PEP Completed auf FALSE festlegt, ignoriert PoFx den Wert im Succeeded-Element .

[in] PerfRequestsCount

Die Anzahl der P-Zustandsänderungen, die im Array angefordert werden, auf das der 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 vom PerfRequestsCount-Element angegeben.

Hinweise

Diese Struktur wird von der PEP_DPM_REQUEST_COMPONENT_PERF_STATE Benachrichtigung verwendet. Die Member DeviceHandle, Component, PerfRequestsCount und PerfRequests der Struktur enthalten Eingabewerte, die von PoFx bereitgestellt werden, wenn diese Benachrichtigung gesendet wird. Die Member Completed und Succeeded enthalten Ausgabewerte, die pep als Reaktion auf die Benachrichtigung in die Struktur schreibt.

Der PEP kann die angeforderten P-Zustandsänderungen entweder synchron oder asynchron durchführen. Pep kann das Completed-Element auf TRUE festlegen, um anzugeben, dass alle Anforderungen in der PEP_DPM_REQUEST_COMPONENT_PERF_STATE Benachrichtigung synchron abgeschlossen wurden, d. h. vor der Rückgabe der AcceptDeviceNotification-Rückrufroutine des PEP. Oder pep kann Completed auf FALSE festlegen, um anzugeben, dass die Anforderungen asynchron abgeschlossen werden. Um die Anforderungen asynchron abzuschließen, sollte pep die RequestWorker-Routine aufrufen, um PoFx darüber zu informieren, dass der PEP eine Arbeitsanforderung zu übermitteln hat, und PoFx antwortet, indem eine PEP_DPM_WORK Benachrichtigung an 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 synchron behandelt, bleibt der Inhalt des PerfRequests-Arrays nur gültig, bis die Rückgabe von der AcceptDeviceNotification-Rückrufroutine erfolgt. Wenn die Anforderungen asynchron abgeschlossen werden, bleibt der Arrayinhalt gültig, bis pep die [CompleteWork-Routine aufruft, um PoFx zu benachrichtigen, dass pep die ausstehenden Anforderungen abgeschlossen hat.