PEP_REQUEST_COMPONENT_PERF_STATE-Struktur (pep_x.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 Verarbeitung 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. Dieses Element ist ein Index in das Array Components in der PEP_DEVICE_REGISTER_V2-Struktur , das der 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 auf TRUE fest, um anzugeben, dass die P-Zustandsänderungen synchron abgeschlossen wurden. Legen Sie auf FALSE fest, um anzugeben, dass die angeforderten P-Zustandsänderungen ausstehen und von einem PEP-Workerthread asynchron abgeschlossen werden. Weitere Informationen finden Sie in den Hinweisen.

[out] Succeeded

Gibt an, ob der angeforderte P-Zustand erfolgreich geändert wurde. Legen Sie auf TRUE fest, wenn pep alle im PerfRequests-Array angeforderten Änderungen des P-Zustands erfolgreich abgeschlossen hat. Legen Sie auf FALSE fest, wenn pep nicht alle angeforderten P-Zustandsänderungen ausführen konnte. In diesem Fall wurden die P-Zustände in der Hardware unverändert gelassen. Das Element Erfolgreich wird nur für synchrone P-Zustandsänderungen verwendet. Wenn PEP Abgeschlossen auf FALSE festlegt, ignoriert PoFx den Wert im Element Erfolgreich .

[in] PerfRequestsCount

Die Anzahl der vom PerfRequests-Member angeforderten P-Zustandsänderungen im Array.

[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-Member 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 Elemente Abgeschlossen und Erfolgreich 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 durchführen. Der PEP kann das Abgeschlossene 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 der PEP kann Abgeschlossen 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 eine Arbeitsanforderung zu übermitteln hat, 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 pep die angeforderten P-Zustandsänderungen synchron verarbeitet, bleibt der Inhalt des PerfRequests-Arrays nur gültig, bis die Rückgabe von der Rückrufroutine AcceptDeviceNotification erfolgt. Wenn die Anforderungen asynchron abgeschlossen werden, bleibt der Arrayinhalt gültig, bis der PEP die CompleteWork-Routine aufruft, um PoFx darüber zu informieren, dass pep die ausstehenden Anforderungen abgeschlossen hat.