función WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT (wudfdevice.h)

  • Artículo

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con 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 con UMDF.

La función WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT inicializa la estructura de 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

None

Observaciones

En primer lugar, la función WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT cero la estructura de 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 IdleAllowUserControl y 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 Value
Finalización del soporte técnico No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino Escritorio
Versión mínima de UMDF 1.11
Encabezado wudfdevice.h

Consulte también

IWDFDevice3::AssignS0IdleSettingsEx

WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS