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 depois que a estrutura é 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.
Valor de retorno
Um valor NTSTATUS que indica êxito ou falha das operações executadas nesse retorno de chamada. Se a falha for retornada, a estrutura, por sua vez, falhará IRP_MN_START_DEVICE.
Observações
Se você estiver escrevendo um driver KMDF para um dispositivo de componente único que define vários estados de energia funcionais, poderá registrar um EvtDeviceWdmPostPoFxRegisterDevice função de retorno de chamada para receber notificação após o registro da estrutura com a estrutura de gerenciamento de energia (PoFx).
Para registrar EvtDeviceWdmPostPoFxRegisterDevice, um driver deve chamar WdfDeviceWdmAssignPowerFrameworkSettings.
O POHANDLE recebido no EvtDeviceWdmPostPoFxRegisterDevice permanece válido até que o driver retorne de EvtDeviceWdmPrePoFxUnregisterDevice.
O driver pode usar o POHANDLE para chamar PoFxSetComponentLatency, PoFxSetComponentResidencye PoFxSetComponentWake para especificar latência, residência e dicas de ativação para a estrutura de energia.
O 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 |
---|---|
da Plataforma de Destino | Universal |
versão mínima do KMDF | 1.11 |
cabeçalho | wdfdevice.h (inclua Wdf.h) |
IRQL | PASSIVE_LEVEL |