estructura PEP_REGISTER_DEVICE_V2 (pep_x.h)

Artículo
02/26/2024

La estructura PEP_REGISTER_DEVICE_V2 describe un dispositivo cuya pila de controladores acaba de registrarse con el marco de administración de energía de Windows (PoFx).

Sintaxis

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;

Miembros

[in] DeviceId

Cadena que identifica de forma única el dispositivo. Este miembro es un puntero a una estructura UNICODE_STRING que contiene una cadena de identificación del dispositivo.

[in] KernelHandle

Valor POHANDLE que representa el registro del dispositivo con PoFx. El complemento de extensión de plataforma (PEP) recibió previamente este identificador de PoFx durante la notificación de PEP_DPM_REGISTER_DEVICE que informó al PEP de que la pila de controladores del dispositivo registró el dispositivo con PoFx.

[in] Register

Puntero a una estructura PEP_DEVICE_REGISTER_V2 que describe los atributos de administración de energía de todos los componentes del dispositivo. Para obtener más información, vea la sección Comentarios.

[out] DeviceHandle

Valor PEPHANDLE que crea el PEP para identificar este dispositivo. PoFx usará este identificador para identificar el dispositivo en futuras notificaciones de administración de energía de dispositivos (DPM).

[out] DeviceAccepted

Valor de enumeración PEP_DEVICE_ACCEPTANCE_TYPE que indica si el PEP reclama la propiedad del dispositivo. El PEP que reclama la propiedad es responsable de controlar las notificaciones de DPM para el dispositivo.

Comentarios

La notificación de PEP_DPM_REGISTER_DEVICE usa esta estructura. Los tres primeros miembros de esta estructura contienen valores de entrada proporcionados por PoFx. Los dos últimos miembros contienen valores de salida que el PEP escribe en la estructura en respuesta a esta notificación.

El miembro Register contiene un puntero a un búfer de entrada asignado por PoFx. PoFx escribe la estructura de PEP_DEVICE_REGISTER_V2 y los datos asociados en esta estructura antes de enviar la notificación PEP_DPM_REGISTER_DEVICE al PEP. El contenido de este búfer permanece válido solo hasta que el PEP termine de controlar la notificación y vuelva de la devolución de llamada AcceptDeviceNotification .