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