structure PEP_REGISTER_DEVICE_V2 (pepfx.h)

La structure PEP_REGISTER_DEVICE_V2 décrit un appareil dont la pile de pilotes vient d’être inscrite auprès du framework 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 façon 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 reçu précédemment ce handle de PoFx pendant la notification PEP_DPM_REGISTER_DEVICE qui a informé le PEP 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 Remarques.

[out] DeviceHandle

Valeur PEPHANDLE créée par le PEP pour identifier cet appareil. PoFx utilise ce handle pour identifier l’appareil à l’avenir notifications DPM (Device Power Management).

[out] DeviceAccepted

Valeur d’énumération PEP_DEVICE_ACCEPTANCE_TYPE qui indique si la propriété des revendications PEP 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 termine la gestion de la notification et retourne à partir de la AcceptDeviceNotification rappel.

Exigences

Voir aussi

AcceptDeviceNotification

PEP_DEVICE_ACCEPTANCE_TYPE

PEP_DEVICE_REGISTER_V2

PEP_DPM_REGISTER_DEVICE

UNICODE_STRING