Funzione WdfDeviceSetPowerCapabilities (wdfdevice.h)

Articolo
02/27/2024

[Si applica a KMDF e UMDF]

Il metodo WdfDeviceSetPowerCapabilities segnala le funzionalità di alimentazione di un dispositivo.

Sintassi

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

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

[in] PowerCapabilities

Puntatore a una struttura di WDF_DEVICE_POWER_CAPABILITIES allocata dal driver.

Valore restituito

nessuno

Osservazioni

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Un driver chiama in genere WdfDeviceSetPowerCapabilities dall'interno di una delle funzioni di callback seguenti:

EvtDriverDeviceAdd
EvtDevicePrepareHardware
EvtDeviceD0Entry (se il valore del parametro PreviousState è WdfPowerDeviceD3Final)
EvtDeviceSelfManagedIoInit
EvtChildListCreateDevice

Se più driver nello stack di driver del dispositivo chiamano WdfDeviceSetPowerCapabilities, il risparmio energia usa i valori forniti dal driver più alto nello stack.

Esempio

L'esempio di codice seguente inizializza una struttura WDF_DEVICE_POWER_CAPABILITIES e quindi chiama 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
                              );

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Versione UMDF minima	2,0
Intestazione	wdfdevice.h (include Wdf.h)
Libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
Regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

WDF_DEVICE_POWER_CAPABILITIES

WDF_DEVICE_POWER_CAPABILITIES_INIT

WdfDeviceSetPnpCapabilities

Condividi tramite