struttura PEP_WORK_POWER_CONTROL (pep_x.h)

Articolo
02/26/2024

La struttura PEP_WORK_POWER_CONTROL contiene i parametri per una richiesta di controllo alimentazione che il plug-in dell'estensione della piattaforma (PEP) invia direttamente a un driver del processore.

Sintassi

typedef struct _PEP_WORK_POWER_CONTROL {
       POHANDLE DeviceHandle;
  [in] LPCGUID  PowerControlCode;
       PVOID    RequestContext;
  [in] PVOID    InBuffer;
  [in] SIZE_T   InBufferSize;
  [in] PVOID    OutBuffer;
  [in] SIZE_T   OutBufferSize;
} PEP_WORK_POWER_CONTROL, *PPEP_WORK_POWER_CONTROL;

Members

DeviceHandle

Valore POHANDLE che identifica il processore. Il PEP ha ricevuto questo handle in una notifica di PEP_DPM_REGISTER_DEVICE precedente.

[in] PowerControlCode

Puntatore a un valore GUID che specifica l'operazione di controllo energia da eseguire.

RequestContext

Puntatore a un valore di contesto definito da PEP. Il PEP potrebbe usare questo valore per identificare in modo univoco un messaggio di richiesta di controllo energia (nel caso in cui il PEP genera più richieste con lo stesso codice di controllo nello stesso dispositivo).

[in] InBuffer

Puntatore a un buffer di input allocato dal driver che contiene i parametri di input per questa operazione di controllo energia.

[in] InBufferSize

Dimensioni in byte del buffer a cui punta InBuffer.

[in] OutBuffer

Puntatore a un buffer di output allocato dal driver a cui il PEP scrive i risultati di questa operazione di controllo energia.

[in] OutBufferSize

Dimensioni in byte del buffer a cui punta OutBuffer.

Commenti

Il membro PowerControl della struttura PEP_WORK_INFORMATION è un puntatore a una struttura PEP_WORK_POWER_CONTROL .

IL PEP rilascia una richiesta di controllo energia da un thread di lavoro. Windows Power Management Framework (PoFx) inoltra questa richiesta chiamando la routine powerControlCallback del driver del processore, se il driver implementa questa routine.