Compartilhar via


Função WdfDeviceInitSetPnpPowerEventCallbacks (wdfdevice.h)

[Aplica-se a KMDF e UMDF]

O método WdfDeviceInitSetPnpPowerEventCallbacks registra as funções de retorno de chamada de evento de gerenciamento de energia e Plug and Play do driver.

Sintaxe

void WdfDeviceInitSetPnpPowerEventCallbacks(
  [in] PWDFDEVICE_INIT               DeviceInit,
  [in] PWDF_PNPPOWER_EVENT_CALLBACKS PnpPowerEventCallbacks
);

Parâmetros

[in] DeviceInit

Um ponteiro fornecido pelo chamador para uma estrutura de WDFDEVICE_INIT .

[in] PnpPowerEventCallbacks

Um ponteiro para uma estrutura de WDF_PNPPOWER_EVENT_CALLBACKS inicializada pelo chamador.

Retornar valor

Nenhum

Comentários

Se o driver chamar WdfDeviceInitSetPnpPowerEventCallbacks, ele deverá fazer isso antes de chamar WdfDeviceCreate.

Para obter mais informações sobre como chamar WdfDeviceCreate, consulte Criando um objeto de dispositivo framework.

Exemplos

O exemplo de código a seguir inicializa uma estrutura WDF_PNPPOWER_EVENT_CALLBACKS e chama WdfDeviceInitSetPnpPowerEventCallbacks.

WDF_PNPPOWER_EVENT_CALLBACKS  pnpPowerCallbacks;

WDF_PNPPOWER_EVENT_CALLBACKS_INIT(&pnpPowerCallbacks);
pnpPowerCallbacks.EvtDevicePrepareHardware = SerialEvtPrepareHardware;
pnpPowerCallbacks.EvtDeviceReleaseHardware = SerialEvtReleaseHardware;
pnpPowerCallbacks.EvtDeviceD0Entry = SerialEvtDeviceD0Entry;
pnpPowerCallbacks.EvtDeviceD0Exit = SerialEvtDeviceD0Exit;
WdfDeviceInitSetPnpPowerEventCallbacks(
                                       DeviceInit,
                                       &pnpPowerCallbacks
                                       );

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho wdfdevice.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
Regras de conformidade de DDI ChildDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), DrvAckIoStop(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Confira também

WDF_PNPPOWER_EVENT_CALLBACKS_INIT

WdfDeviceInitSetPowerPolicyEventCallbacks