Función WdfDeviceSetPowerCapabilities (wdfdevice.h)

[Se aplica a KMDF y UMDF]

El método WdfDeviceSetPowerCapabilities informa de las funcionalidades de energía de un dispositivo.

Sintaxis

VOID WdfDeviceSetPowerCapabilities(
  [in] WDFDEVICE                      Device,
  [in] PWDF_DEVICE_POWER_CAPABILITIES PowerCapabilities
);

Parámetros

[in] Device

Identificador de un objeto de dispositivo de marco.

[in] PowerCapabilities

Puntero a una estructura de WDF_DEVICE_POWER_CAPABILITIES asignada por el controlador.

Valor devuelto

Ninguno

Observaciones

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Normalmente, un controlador llama a WdfDeviceSetPowerCapabilities desde una de las siguientes funciones de devolución de llamada:

• EvtDriverDeviceAdd

• EvtDevicePrepareHardware

• EvtDeviceD0Entry (si el valor del parámetro PreviousState es WdfPowerDeviceD3Final)

• EvtDeviceSelfManagedIoInit

• EvtChildListCreateDevice

Ejemplos

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

WDF_DEVICE_POWER_CAPABILITIES powerCaps;

WDF_DEVICE_POWER_CAPABILITIES_INIT(&powerCaps);
powerCaps.DeviceD1 = WdfTrue;
powerCaps.WakeFromD1 = WdfTrue;
powerCaps.DeviceWake = PowerDeviceD1;
powerCaps.DeviceState[PowerSystemWorking] = PowerDeviceD1;
powerCaps.DeviceState[PowerSystemSleeping1] = PowerDeviceD1;
powerCaps.DeviceState[PowerSystemSleeping2] = PowerDeviceD2;
powerCaps.DeviceState[PowerSystemSleeping3] = PowerDeviceD2;
powerCaps.DeviceState[PowerSystemHibernate] = PowerDeviceD3;
powerCaps.DeviceState[PowerSystemShutdown] = PowerDeviceD3;

WdfDeviceSetPowerCapabilities(
                              device,
                              &powerCaps
                              );

Requisitos

Consulte también

WDF_DEVICE_POWER_CAPABILITIES

WDF_DEVICE_POWER_CAPABILITIES_INIT

WdfDeviceSetPnpCapabilities