função WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT (wudfdevice.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui o UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum recurso novo está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução aoda UMDF .]
A função WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT inicializa a estrutura de WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS de um driver.
Sintaxe
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
Um ponteiro para uma estrutura de WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS alocada pelo driver.
[in] IdleCaps
Um enumerador tipo WDF_POWER_POLICY_S0_IDLE_CAPABILITIES.
Valor de retorno
Nenhum
Observações
Primeiro, a função WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT zera a estrutura de WUDF_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 como WdfUseDefault.
Em seguida, 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 WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT, consulte IWDFDevice3::AssignS0IdleSettingsEx.
Requisitos
| Requisito | Valor |
|---|---|
| fim do suporte | Indisponível no UMDF 2.0 e posterior. |
| da Plataforma de Destino | Área de trabalho |
| versão mínima do UMDF | 1.11 |
| cabeçalho | wudfdevice.h |