EVT_WDF_DEVICE_ARM_WAKE_FROM_SX_WITH_REASON função de retorno de chamada (wdfdevice.h)
[Aplica-se a KMDF e UMDF]
O de um driver EvtDeviceArmWakeFromSxWithReason braços de função de retorno de chamada de evento (ou seja, habilita) um dispositivo para que ele possa disparar um sinal de ativação enquanto estiver em um estado de dispositivo de baixa potência. O sinal de ativação faz com que o dispositivo insira seu estado de trabalho (D0) e faz com que o sistema insira seu estado de trabalho (S0).
Sintaxe
EVT_WDF_DEVICE_ARM_WAKE_FROM_SX_WITH_REASON EvtWdfDeviceArmWakeFromSxWithReason;
NTSTATUS EvtWdfDeviceArmWakeFromSxWithReason(
[in] WDFDEVICE Device,
[in] BOOLEAN DeviceWakeEnabled,
[in] BOOLEAN ChildrenArmedForWake
)
{...}
Parâmetros
[in] Device
Um identificador para um objeto de dispositivo de estrutura.
[in] DeviceWakeEnabled
Um valor booliano que, se verdadeiro, indica que a capacidade do dispositivo de ativar o sistema está habilitada.
[in] ChildrenArmedForWake
Um valor booliano que, se VERDADEIRO, indica que a capacidade de um ou mais dispositivos filho de ativar o sistema está habilitada.
Valor de retorno
Se a função de retorno de chamada EvtDeviceArmWakeFromSxWithReason não encontrar nenhum erro, ela deverá retornar STATUS_SUCCESS ou outro valor de status para o qual NT_SUCCESS(status) é igual a TRUE. Caso contrário, ele deverá retornar um valor de status para o qual NT_SUCCESS(status) é igual a FALSE.
Se NT_SUCCESS(status) for igual a FALSE, a estrutura chamará a função de retorno de chamada do driver EvtDeviceDisarmWakeFromSx. (A estrutura não relata uma falha de dispositivo para o gerenciador PnP.)
Observações
A versão 1.7 e versões posteriores do KMDF dão suporte à função de retorno de chamada EvtDeviceArmWakeFromSxWithReason, além da função de retorno de chamada EvtDeviceArmWakeFromSx.
Para registrar uma função de retorno de chamada EvtDeviceArmWakeFromSxWithReason, um driver deve chamar WdfDeviceInitSetPowerPolicyEventCallbacks. Os drivers podem registrar uma função de retorno de chamada EvtDeviceArmWakeFromSx ou um EvtDeviceArmWakeFromSxWithReason função de retorno de chamada, mas não ambos.
A função de retorno de chamada EvtDeviceArmWakeFromSxWithReason fornece dois parâmetros que permitem ao driver determinar por que a estrutura a chamou:
- A estrutura define o parâmetro DeviceWakeEnabled para verdadeiro se o membro habilitado para da estrutura WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS indicar que o dispositivo pode ativar o sistema.
- A estrutura define o parâmetro ChildrenArmedForWake para TRUE se um ou mais dos dispositivos filho do dispositivo puder ativar o sistema e o ArmForWakeIfChildrenAreArmedForWake membro do WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS estiver definido como VERDADEIRO.
- O dispositivo do driver está habilitado para ativar o sistema.
- Um ou mais dos dispositivos filho do dispositivo estão habilitados para ativar o sistema.
- O dispositivo e um ou mais de seus dispositivos filho estão habilitados para ativar o sistema.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.7 |
| versão mínima do UMDF | 2.0 |
| cabeçalho | wdfdevice.h (inclua Wdf.h) |
| IRQL | PASSIVE_LEVEL |