función WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT (wudfdevice.h)
[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los nuevos controladores UMDF deben escribirse mediante UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción a UMDF.]
La función WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT inicializa la estructura WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS de un controlador.
Sintaxis
void WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT(
[out] PWUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS Settings,
[in] WDF_POWER_POLICY_S0_IDLE_CAPABILITIES IdleCaps
);
Parámetros
[out] Settings
Puntero a una estructura de WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS asignada por el controlador.
[in] IdleCaps
Enumerador con tipo WDF_POWER_POLICY_S0_IDLE_CAPABILITIES.
Valor devuelto
Ninguno
Observaciones
En primer lugar, la función WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT cero la estructura WUDF_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 IdleAllowUserControly establece el miembro Enabled en WdfUseDefault.
Además, la función establece el miembro powerUpIdleDeviceOnSystemWake en WdfUseDefault.
A continuación, 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.
Para obtener un ejemplo de código que usa WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT, vea IWDFDevice3::AssignS0IdleSettingsEx.
Requisitos
| Requisito | Valor |
|---|---|
| fin del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| de la plataforma de destino de | Escritorio |
| versión mínima de UMDF | 1.11 |
| encabezado de | wudfdevice.h |