EVT_WDF_DEVICE_WAKE_FROM_SX_TRIGGERED função de retorno de chamada (wdfdevice.h)

[Aplica-se a KMDF e UMDF]

A função de retorno de chamada de evento EvtDeviceWakeFromSxTriggered de um driver informa ao driver que seu dispositivo, que havia entrado anteriormente em um estado de dispositivo de baixa potência porque a energia do sistema foi reduzida, pode ter disparado um sinal de ativação.

Sintaxe

EVT_WDF_DEVICE_WAKE_FROM_SX_TRIGGERED EvtWdfDeviceWakeFromSxTriggered;

void EvtWdfDeviceWakeFromSxTriggered(
  [in] WDFDEVICE Device
)
{...}

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

Retornar valor

Nenhum

Comentários

Para registrar uma função de retorno de chamada EvtDeviceWakeFromSxTriggered , um driver deve chamar WdfDeviceInitSetPowerPolicyEventCallbacks.

Se o driver tiver registrado esse retorno de chamada, a estrutura a chamará depois de chamar a função de retorno de chamada EvtDeviceD0Entry do driver e antes de chamar a função de retorno de chamada EvtDeviceDisarmWakeFromSx do driver.

O hardware do sistema (BIOSes, placas-mãe, adaptadores de ônibus) às vezes pode soltar um sinal de ativação antes que o motorista do ônibus o detecte, mesmo que o sinal ative o sistema. Nesses casos, a função de retorno de chamada EvtDeviceWakeFromSxTriggered do driver não será chamada, mesmo que o dispositivo do driver tenha disparado um sinal de ativação.

Alguns ônibus combinam sinais de ativação de várias crianças. Se o dispositivo estiver conectado a um desses barramentos, a função de retorno de chamada poderá precisar determinar se o dispositivo atual disparou o sinal de ativação. Se o dispositivo fornecer uma trava de hardware que salva o estado disparado do dispositivo, é melhor marcar esse estado na função de retorno de chamada EvtDeviceDisarmWakeFromSx do driver, porque esse retorno de chamada é sempre chamado depois que o dispositivo é ativado, mesmo que o sinal de ativação tenha sido descartado.

Para obter mais informações sobre essa função de retorno de chamada, consulte Suporte à ativação do sistema.

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)
IRQL PASSIVE_LEVEL

Confira também

EvtDeviceArmWakeFromSx

EvtDeviceDisarmWakeFromSx

EvtDeviceWakeFromS0Triggered