struttura PEP_REGISTER_DEVICE_V2 (pepfx.h)

Articolo
03/05/2024

La struttura PEP_REGISTER_DEVICE_V2 descrive un dispositivo il cui stack di driver è stato appena registrato con il framework di risparmio energia di Windows (PoFx).

Sintassi

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;

Members

[in] DeviceId

Stringa che identifica in modo univoco il dispositivo. Questo membro è un puntatore a una struttura UNICODE_STRING che contiene una stringa di identificazione del dispositivo.

[in] KernelHandle

Valore POHANDLE che rappresenta la registrazione del dispositivo con PoFx. Il plug-in di estensione della piattaforma (PEP) ha ricevuto in precedenza questo handle da PoFx durante la notifica PEP_DPM_REGISTER_DEVICE che informa il PEP che lo stack di driver del dispositivo ha registrato il dispositivo con PoFx.

[in] Register

Puntatore a una struttura PEP_DEVICE_REGISTER_V2 che descrive gli attributi di risparmio energia di tutti i componenti del dispositivo. Per altre informazioni, vedere la sezione Osservazioni.

[out] DeviceHandle

Valore PEPHANDLE creato da PEPHANDLE per identificare questo dispositivo. PoFx userà questo handle per identificare il dispositivo nelle notifiche future di risparmio energia del dispositivo (DPM).

[out] DeviceAccepted

Valore di enumerazione PEP_DEVICE_ACCEPTANCE_TYPE che indica se il PEP dichiara la proprietà del dispositivo. Il PEP che dichiara la proprietà è responsabile della gestione delle notifiche DPM per il dispositivo.

Commenti

Questa struttura viene utilizzata dalla notifica di PEP_DPM_REGISTER_DEVICE . I primi tre membri di questa struttura contengono valori di input forniti da PoFx. Gli ultimi due membri contengono valori di output scritti dal PEP nella struttura in risposta a questa notifica.

Il membro Register contiene un puntatore a un buffer di input allocato da PoFx. PoFx scrive la struttura PEP_DEVICE_REGISTER_V2 e i dati associati in questa struttura prima di inviare la notifica PEP_DPM_REGISTER_DEVICE al PEP. Il contenuto di questo buffer rimane valido solo finché il PEP non completa la gestione della notifica e restituisce dal callback AcceptDeviceNotification .