función WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT (wdfdevice.h)
[Se aplica a KMDF y UMDF]
La función WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT inicializa la estructura WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS de un controlador.
Sintaxis
void WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT(
[out] PWDF_DEVICE_POWER_POLICY_IDLE_SETTINGS Settings,
[in] WDF_POWER_POLICY_S0_IDLE_CAPABILITIES IdleCaps
);
Parámetros
[out] Settings
Puntero a una estructura de WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS asignada por el controlador.
[in] IdleCaps
Enumerador con tipo WDF_POWER_POLICY_S0_IDLE_CAPABILITIES.
Valor devuelto
None
Observaciones
En primer lugar, la función WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT cero la estructura de WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS especificada y establece el miembro Size de la estructura.
A continuación, la función establece el miembro IdleTimeout de la estructura en IdleTimeoutDefaultValue, establece el miembro UserControlOfIdleSettings en IdleAllowUserControl y establece el miembro Enabled en WdfUseDefault.
Además, la función establece el miembro PowerUpIdleDeviceOnSystemWake en WdfUseDefault y el miembro IdleTimeoutType en DriverManagedIdleTimeout.
Además, la función establece el miembro ExcludeD3Cold en WdfUseDefault.
A continuación, la función establece el miembro IdleCaps de la estructura en el valor que especifica el parámetro IdleCaps .
Por último, si el parámetro IdleCaps especifica IdleUsbSelectiveSuspend o IdleCanWakeFromS0, la función establece el miembro DxState en PowerDeviceMaximum. Si el parámetro IdleCaps especifica IdleCannotWakeFromS0, la función establece el miembro DxState en PowerDeviceD3.
Ejemplos
Para obtener un ejemplo de código que usa WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT, vea WdfDeviceAssignS0IdleSettings.
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 (incluya Wdf.h) |