Compartilhar via


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.
Um ou ambos os parâmetros podem ser VERDADEIRO, devido aos seguintes cenários:
  • 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.
Para obter mais informações sobre a função de retorno de chamada EvtDeviceArmWakeFromSxWithReason, consulte a seção Comentários de EvtDeviceArmWakeFromSx.

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

Consulte também

EvtDeviceArmWakeFromS0

EvtDeviceArmWakeFromSx

EvtDeviceDisarmWakeFromSx