Compartilhar via

função WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT (wdfdevice.h)

  • Artigo

[Aplica-se a KMDF e UMDF]

A função WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT inicializa a estrutura de WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS de um driver.

Sintaxe

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

Um ponteiro para uma estrutura de WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS alocada pelo driver.

[in] IdleCaps

Um enumerador do tipo WDF_POWER_POLICY_S0_IDLE_CAPABILITIES.

Retornar valor

Nenhum

Comentários

Primeiro, a função WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT zerar a estrutura de WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS especificada e define o membro Size da estrutura.

Em seguida, a função define o membro IdleTimeout da estrutura como IdleTimeoutDefaultValue, define o membro UserControlOfIdleSettings como IdleAllowUserControl e define o membro Enabled como WdfUseDefault.

Além disso, a função define o membro PowerUpIdleDeviceOnSystemWake como WdfUseDefault e o membro IdleTimeoutType como DriverManagedIdleTimeout.

Além disso, a função define o membro ExcludeD3Cold como WdfUseDefault.

Em seguida, a função define o membro IdleCaps da estrutura como o valor especificado pelo parâmetro IdleCaps .

Por fim, se o parâmetro IdleCaps especifica IdleUsbSelectiveSuspend ou IdleCanWakeFromS0, a função define o membro DxState como PowerDeviceMaximum. Se o parâmetro IdleCapsespecificar IdleCannotWakeFromS0, a função definirá o membro DxState como PowerDeviceD3.

Exemplos

Para obter um exemplo de código que usa WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT, consulte WdfDeviceAssignS0IdleSettings.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho wdfdevice.h (inclua Wdf.h)

Confira também

WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS