PEP_REQUEST_COMPONENT_PERF_STATE struttura (pep_x.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 Gestione energia di Windows (PoFx), oltre alle informazioni sullo stato sulla gestione di queste richieste dal plug-in dell'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 da PEP in risposta alla notifica di PEP_DPM_REGISTER_DEVICE per questo dispositivo. Se la matrice Components contiene elementi N, gli indici dei componenti sono compresi tra 0 e N-1.

[out] Completed

Se il PEP ha completato le modifiche dello stato P richieste. Impostare su TRUE per indicare che lo stato P viene modificato in modo sincrono. Impostare su FALSE per indicare che le modifiche dello 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

Se la modifica dello stato P richiesto è stata completata correttamente. Impostare su TRUE se il PEP ha completato correttamente tutte le modifiche dello stato P richieste nella matrice PerfRequests . Impostare su FALSE se il PEP non è stato in grado di eseguire tutte le modifiche di stato P richieste, in questo caso gli stati P nell'hardware sono stati lasciati invariati. Il membro Successed viene usato solo per le modifiche dello stato P sincrone . Se il PEP imposta Completato su FALSE, PoFx ignora il valore nel membro Successed .

[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 della 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 usata 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 questa notifica viene inviata. I membri completati e riusciti contengono valori di output che il PEP scrive 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 Completato 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 Complete 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 risponderà inviando una notifica PEP_DPM_WORK al PEP.

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