função WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT (wdfdevice.h)
[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.
void WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT(
[out] PWDF_DEVICE_POWER_POLICY_IDLE_SETTINGS Settings,
[in] WDF_POWER_POLICY_S0_IDLE_CAPABILITIES IdleCaps
);
[out] Settings
Um ponteiro para uma estrutura de WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS alocada pelo driver.
[in] IdleCaps
Um enumerador tipo WDF_POWER_POLICY_S0_IDLE_CAPABILITIES.
Nenhum
Primeiro, a função WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT zera a estrutura de WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS especificada e define o membro tamanho 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 Habilitado para para WdfUseDefault.
Além disso, a função define o membro PowerUpIdleDeviceOnSystemWake para WdfUseDefault e o membro IdleTimeoutType para DriverManagedIdleTimeout.
Além disso, a função define o membro ExcludeD3Cold como WdfUseDefault .
Em seguida, a função define o membro IdleCaps da estrutura com o valor especificado pelo parâmetro IdleCaps.
Por fim, se o parâmetro IdleCaps especificar IdleUsbSelectiveSuspend ou IdleCanWakeFromS0, a função definirá o membro DxState como PowerDeviceMaximum. Se o parâmetro IdleCaps especificar IdleCannotWakeFromS0, a função definirá o membro DxState como PowerDeviceD3.
Para obter um exemplo de código que usa WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT, consulte WdfDeviceAssignS0IdleSettings.
| Requisito | Valor |
|---|---|
| da 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) |