EVT_WDFDEVICE_WDM_POST_PO_FX_REGISTER_DEVICE función de devolución de llamada (wdfdevice.h)

  • Artículo

[Solo se aplica a KMDF]

La función de devolución de llamada EvtDeviceWdmPostPoFxRegisterDevice realiza operaciones específicas del dispositivo después de que el marco se haya registrado con power framework.

Sintaxis

EVT_WDFDEVICE_WDM_POST_PO_FX_REGISTER_DEVICE EvtWdfdeviceWdmPostPoFxRegisterDevice;

NTSTATUS EvtWdfdeviceWdmPostPoFxRegisterDevice(
  [in] WDFDEVICE Device,
  [in] POHANDLE PoHandle
)
{...}

Parámetros

[in] Device

Identificador de un objeto de dispositivo de marco.

[in] PoHandle

Identificador que representa el registro del dispositivo con power Framework.

Valor devuelto

Valor NTSTATUS que indica que las operaciones se han realizado correctamente o no en esta devolución de llamada. Si se devuelve un error, el marco a su vez producirá un error IRP_MN_START_DEVICE.

Comentarios

Si va a escribir un controlador KMDF para un dispositivo de un solo componente que define varios estados de energía funcionales, puede registrar una función de devolución de llamada EvtDeviceWdmPostPoFxRegisterDevice para recibir notificaciones después de que el marco se registre en el marco de administración de energía (PoFx).

Para registrar EvtDeviceWdmPostPoFxRegisterDevice, un controlador debe llamar a WdfDeviceWdmAssignPowerFrameworkSettings.

El POHANDLE recibido en EvtDeviceWdmPostPoFxRegisterDevice sigue siendo válido hasta que el controlador vuelva de EvtDeviceWdmPrePoFxUnregisterDevice.

El controlador puede usar POHANDLE para llamar a PoFxSetComponentLatency, PoFxSetComponentResidency y PoFxSetComponentWake para especificar sugerencias de latencia, residencia y reactivación en el marco de trabajo de energía.

El controlador también puede usar poHANDLE para llamar a PoFxPowerControl para enviar una solicitud de control de energía a PoFx.

Un controlador KMDF para un dispositivo de varios componentes no proporciona EvtDeviceWdmPostPoFxRegisterDevice. En su lugar, este controlador recibe el POHANDLE cuando llama a PoFxRegisterDevice. Para obtener más información, consulte Compatibilidad con varios estados de energía funcionales para dispositivos Multiple-Component.

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.11
Encabezado wdfdevice.h (incluir Wdf.h)
IRQL PASSIVE_LEVEL

Consulte también

EvtDeviceWdmPrePoFxUnregisterDevice

WdfDeviceWdmAssignPowerFrameworkSettings