struttura PEP_REQUEST_COMPONENT_PERF_STATE (pepfx.h)

Articolo
08/07/2023

La struttura PEP_REQUEST_COMPONENT_PERF_STATE contiene un elenco di modifiche dello stato delle prestazioni (P-state) richieste dal framework di risparmio energia di Windows (PoFx), oltre a informazioni sullo stato sulla gestione di queste richieste dal plug-in di estensione della piattaforma (PEP).

Sintassi

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;

Members

[in] DeviceHandle

Valore PEPHANDLE che identifica il dispositivo. Il PEP ha fornito questo handle in risposta a una notifica di PEP_DPM_REGISTER_DEVICE precedente.

[in] Component

Indice che identifica il componente. Questo membro è un indice nella matrice Components nella struttura PEP_DEVICE_REGISTER_V2 fornita in precedenza dal PEP in risposta alla notifica di PEP_DPM_REGISTER_DEVICE per questo dispositivo. Se la matrice Components contiene N elementi, gli indici dei componenti sono compresi tra 0 e N-1.

[out] Completed

Indica se il PEP ha completato le modifiche dello stato P richieste. Impostare su TRUE per indicare che le modifiche dello stato P sono state completate in modo sincrono. Impostare su FALSE per indicare che le modifiche di stato P richieste sono in sospeso e verranno completate in modo asincrono da un thread di lavoro PEP. Per altre informazioni, vedere la sezione Osservazioni.

[out] Succeeded

Indica se lo stato P richiesto è stato completato correttamente. Impostare su TRUE se il PEP ha completato tutte le modifiche dello stato P richieste nella matrice PerfRequests . Impostare su FALSE se il PEP non è riuscito a eseguire tutte le modifiche di stato P richieste, nel qual caso gli stati P nell'hardware sono rimasti invariati. Il membro Succeeded viene usato solo per le modifiche sincrone dello stato P. Se pep imposta Completed su FALSE, PoFx ignora il valore nel membro Succeeded .

[in] PerfRequestsCount

Numero di modifiche dello stato P richieste nella matrice a cui punta il membro PerfRequests .

[in] PerfRequests

Puntatore a una matrice di strutture PEP_COMPONENT_PERF_STATE_REQUEST . Ogni elemento nella matrice specifica un nuovo livello di prestazioni da assegnare a un set di stato P. Il numero di elementi della matrice viene specificato dal membro PerfRequestsCount .

Commenti

Questa struttura viene utilizzata dalla notifica di PEP_DPM_REQUEST_COMPONENT_PERF_STATE . I membri DeviceHandle, Component, PerfRequestsCount e PerfRequests della struttura contengono valori di input forniti da PoFx quando viene inviata questa notifica. I membri Completed e Succeeded contengono valori di output scritti dal PEP nella struttura in risposta alla notifica.

Il PEP può completare le modifiche dello stato P richieste in modo sincrono o asincrono. Il PEP può impostare il membro Completed su TRUE per indicare che tutte le richieste nella notifica di PEP_DPM_REQUEST_COMPONENT_PERF_STATE sono state completate in modo sincrono, ovvero prima del ritorno dalla routine di callback AcceptDeviceNotification di PEP. In alternativa, il PEP può impostare Completed su FALSE per indicare che le richieste verranno completate in modo asincrono. Per completare le richieste in modo asincrono, il PEP deve chiamare la routine RequestWorker per informare PoFx che il PEP ha una richiesta di lavoro da inviare e PoFx risponde inviando una notifica di PEP_DPM_WORK al PEP.

PoFx scrive le modifiche dello stato P richieste nella matrice PerfRequests prima dell'invio della notifica di PEP_DPM_REQUEST_COMPONENT_PERF_STATE . Se pep gestisce in modo sincrono le modifiche dello stato P richieste, il contenuto della matrice PerfRequests rimane valido solo fino a quando non viene restituito dalla routine di callback AcceptDeviceNotification . Se le richieste vengono completate in modo asincrono, il contenuto della matrice rimane valido fino a quando il PEP non chiama la [routine CompleteWork per notificare a PoFx che il PEP ha completato le richieste in sospeso.