Función WdfDeviceInitSetPowerPolicyEventCallbacks (wdfdevice.h)

Artículo
08/08/2023

[Se aplica a KMDF y UMDF]

El método WdfDeviceInitSetPowerPolicyEventCallbacks registra las funciones de devolución de llamada de eventos de directiva de energía de un controlador.

Sintaxis

void WdfDeviceInitSetPowerPolicyEventCallbacks(
  [in] PWDFDEVICE_INIT                   DeviceInit,
  [in] PWDF_POWER_POLICY_EVENT_CALLBACKS PowerPolicyEventCallbacks
);

Parámetros

[in] DeviceInit

Puntero proporcionado por el autor de la llamada a una estructura WDFDEVICE_INIT .

[in] PowerPolicyEventCallbacks

Puntero a una estructura de WDF_POWER_POLICY_EVENT_CALLBACKS inicializada por el autor de la llamada.

Valor devuelto

None

Observaciones

Si el controlador llama a WdfDeviceInitSetPowerPolicyEventCallbacks, debe hacerlo antes de llamar a WdfDeviceCreate. Para obtener más información, vea Creating a Framework Device Object.

Para obtener más información sobre WdfDeviceInitSetPowerPolicyEventCallbacks, vea Propiedad de Power Policy.

Ejemplos

En el ejemplo de código siguiente se inicializa una estructura de WDF_POWER_POLICY_EVENT_CALLBACKS y, a continuación, se llama a WdfDeviceInitSetPowerPolicyEventCallbacks.

WDF_POWER_POLICY_EVENT_CALLBACKS powerPolicyCallbacks;

WDF_POWER_POLICY_EVENT_CALLBACKS_INIT(&powerPolicyCallbacks);
powerPolicyCallbacks.EvtDeviceArmWakeFromS0 = PciDrvEvtDeviceWakeArmS0;
powerPolicyCallbacks.EvtDeviceDisarmWakeFromS0 = PciDrvEvtDeviceWakeDisarmS0;
powerPolicyCallbacks.EvtDeviceWakeFromS0Triggered = PciDrvEvtDeviceWakeTriggeredS0;
powerPolicyCallbacks.EvtDeviceArmWakeFromSx = PciDrvEvtDeviceWakeArmSx;
powerPolicyCallbacks.EvtDeviceDisarmWakeFromSx = PciDrvEvtDeviceWakeDisarmSx;
powerPolicyCallbacks.EvtDeviceWakeFromSxTriggered = PciDrvEvtDeviceWakeTriggeredSx;
WdfDeviceInitSetPowerPolicyEventCallbacks(
                                          DeviceInit,
                                          &powerPolicyCallbacks
                                          );

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Versión mínima de UMDF	2.0
Encabezado	wdfdevice.h (incluir Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
Reglas de cumplimiento de DDI	ChildDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), FDOPowerPolicyOwnerAPI(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), NonFDONotPowerPolicyOwnerAPI(kmdf), PdoDeviceInitAPI(kmdf)

Consulte también

WDF_POWER_POLICY_EVENT_CALLBACKS_INIT

WdfDeviceInitSetPnpPowerEventCallbacks