EVT_WDFDEVICE_WDM_POST_PO_FX_REGISTER_DEVICE função de retorno de chamada (wdfdevice.h)
[Aplica-se somente ao KMDF]
A função de retorno de chamada EvtDeviceWdmPostPoFxRegisterDevice executa operações específicas do dispositivo após a estrutura ter sido registrada com a estrutura de energia.
Sintaxe
EVT_WDFDEVICE_WDM_POST_PO_FX_REGISTER_DEVICE EvtWdfdeviceWdmPostPoFxRegisterDevice;
NTSTATUS EvtWdfdeviceWdmPostPoFxRegisterDevice(
[in] WDFDEVICE Device,
[in] POHANDLE PoHandle
)
{...}
Parâmetros
[in] Device
Um identificador para um objeto de dispositivo de estrutura.
[in] PoHandle
Um identificador que representa o registro do dispositivo com a estrutura de energia.
Retornar valor
Um valor NTSTATUS que indica êxito ou falha das operações executadas neste retorno de chamada. Se a falha for retornada, a estrutura falhará IRP_MN_START_DEVICE.
Comentários
Se você estiver escrevendo um driver KMDF para um dispositivo de componente único que define vários estados de energia funcionais, poderá registrar uma função de retorno de chamada EvtDeviceWdmPostPoFxRegisterDevice para receber notificação depois que a estrutura se registrar na estrutura de gerenciamento de energia (PoFx).
Para registrar EvtDeviceWdmPostPoFxRegisterDevice, um driver deve chamar WdfDeviceWdmAssignPowerFrameworkSettings.
O POHANDLE recebido em EvtDeviceWdmPostPoFxRegisterDevice permanece válido até que o driver retorne de EvtDeviceWdmPrePoFxUnregisterDevice.
Seu driver pode usar o POHANDLE para chamar PoFxSetComponentLatency, PoFxSetComponentResidency e PoFxSetComponentWake para especificar latência, residência e dicas de ativação para a estrutura de energia.
Seu driver também pode usar o POHANDLE para chamar PoFxPowerControl para enviar uma solicitação de controle de energia para PoFx.
Um driver KMDF para um dispositivo de vários componentes não fornece EvtDeviceWdmPostPoFxRegisterDevice. Em vez disso, esse driver recebe o POHANDLE quando chama PoFxRegisterDevice. Para obter mais informações, consulte Suporte a vários estados de energia funcionais para dispositivos Multiple-Component.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.11 |
| Cabeçalho | wdfdevice.h (inclua Wdf.h) |
| IRQL | PASSIVE_LEVEL |