PEP_WORK_POWER_CONTROL structure (pep_x.h)

Article
02/26/2024

La structure PEP_WORK_POWER_CONTROL contient les paramètres d’une demande de contrôle d’alimentation que le plug-in d’extension de plateforme (PEP) envoie directement à un pilote de processeur.

Syntaxe

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;

Membres

DeviceHandle

Valeur POHANDLE qui identifie le processeur. Le pep a reçu ce handle dans une notification PEP_DPM_REGISTER_DEVICE précédente.

[in] PowerControlCode

Pointeur vers une valeur GUID qui spécifie l’opération de contrôle d’alimentation à effectuer.

RequestContext

Pointeur vers une valeur de contexte définie par peps. Le PEP peut utiliser cette valeur pour identifier de manière unique un message de demande de contrôle d’alimentation (au cas où le PEP émet plusieurs demandes avec le même code de contrôle sur le même appareil).

[in] InBuffer

Pointeur vers une mémoire tampon d’entrée allouée par le pilote qui contient les paramètres d’entrée pour cette opération de contrôle d’alimentation.

[in] InBufferSize

Taille en octets de la mémoire tampon pointée par InBuffer.

[in] OutBuffer

Pointeur vers une mémoire tampon de sortie allouée par le pilote dans laquelle le PEP écrit les résultats de cette opération de contrôle d’alimentation.

[in] OutBufferSize

Taille en octets de la mémoire tampon pointée par OutBuffer.

Remarques

Le membre PowerControl de la structure PEP_WORK_INFORMATION est un pointeur vers une structure PEP_WORK_POWER_CONTROL .

Le pep émet une demande de contrôle d’alimentation à partir d’un thread de travail. L’infrastructure de gestion de l’alimentation Windows (PoFx) transfère cette requête en appelant la routine PowerControlCallback du pilote de processeur, si le pilote implémente cette routine.