PEP_REGISTER_DEVICE_V2 structure (pep_x.h)

Article
02/29/2024

La structure PEP_REGISTER_DEVICE_V2 décrit un appareil dont la pile de pilotes vient d’être inscrite auprès de l’infrastructure de gestion de l’alimentation Windows (PoFx).

Syntaxe

typedef struct _PEP_REGISTER_DEVICE_V2 {
  [in]  PCUNICODE_STRING           DeviceId;
  [in]  POHANDLE                   KernelHandle;
  [in]  PPEP_DEVICE_REGISTER_V2    Register;
  [out] PEPHANDLE                  DeviceHandle;
  [out] PEP_DEVICE_ACCEPTANCE_TYPE DeviceAccepted;
} PEP_REGISTER_DEVICE_V2, *PPEP_REGISTER_DEVICE_V2;

Membres

[in] DeviceId

Chaîne qui identifie de manière unique l’appareil. Ce membre est un pointeur vers une structure UNICODE_STRING qui contient une chaîne d’identification d’appareil.

[in] KernelHandle

Valeur POHANDLE qui représente l’inscription de l’appareil auprès de PoFx. Le plug-in d’extension de plateforme (PEP) a précédemment reçu ce handle de PoFx lors de la notification PEP_DPM_REGISTER_DEVICE qui l’a informé que la pile de pilotes de l’appareil a inscrit l’appareil auprès de PoFx.

[in] Register

Pointeur vers une structure PEP_DEVICE_REGISTER_V2 qui décrit les attributs de gestion de l’alimentation de tous les composants de l’appareil. Pour plus d'informations, consultez la section Notes.

[out] DeviceHandle

Valeur PEPHANDLE que le PEP crée pour identifier cet appareil. PoFx utilisera ce handle pour identifier l’appareil dans les futures notifications de gestion de l’alimentation des appareils (DPM).

[out] DeviceAccepted

Valeur d’énumération PEP_DEVICE_ACCEPTANCE_TYPE qui indique si le PEP revendique la propriété de l’appareil. Le pep qui revendique la propriété est responsable de la gestion des notifications DPM pour l’appareil.

Remarques

Cette structure est utilisée par la notification PEP_DPM_REGISTER_DEVICE . Les trois premiers membres de cette structure contiennent des valeurs d’entrée fournies par PoFx. Les deux derniers membres contiennent des valeurs de sortie que le PEP écrit dans la structure en réponse à cette notification.

Le membre Register contient un pointeur vers une mémoire tampon d’entrée allouée par PoFx. PoFx écrit la structure PEP_DEVICE_REGISTER_V2 et les données associées dans cette structure avant d’envoyer la notification PEP_DPM_REGISTER_DEVICE au PEP. Le contenu de cette mémoire tampon reste valide uniquement jusqu’à ce que le PEP ait terminé de gérer la notification et retourne à partir du rappel AcceptDeviceNotification .