función WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT (wdfdevice.h)

  • Artículo

[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)

Consulte también

WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS