EVT_WDF_DEVICE_ENABLE_WAKE_AT_BUS função de retorno de chamada (wdfpdo.h)

  • Artigo

[Aplica-se somente ao KMDF]

A função de retorno de chamada de evento EvtDeviceEnableWakeAtBus de um motorista de ônibus executa operações no nível do ônibus que permitem que um dos dispositivos do ônibus dispare um sinal de ativação no ônibus.

Sintaxe

EVT_WDF_DEVICE_ENABLE_WAKE_AT_BUS EvtWdfDeviceEnableWakeAtBus;

NTSTATUS EvtWdfDeviceEnableWakeAtBus(
  [in] WDFDEVICE Device,
  [in] SYSTEM_POWER_STATE PowerState
)
{...}

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

[in] PowerState

Um enumerador do tipo SYSTEM_POWER_STATE que identifica o estado de energia do sistema do qual o sistema ou o dispositivo será ativado.

Retornar valor

Se a função de retorno de chamada EvtDeviceEnableWakeAtBus não encontrar erros, ela deverá retornar STATUS_SUCCESS ou outro valor status para o qual NT_SUCCESS(status) é igual a TRUE. Caso contrário, ele deverá retornar um valor 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 EvtDeviceDisableWakeAtBus do driver.

Para obter mais informações sobre os valores retornados dessa função de retorno de chamada, consulte Relatando falhas de dispositivo.

Comentários

Para registrar essa função de retorno de chamada, o driver de barramento deve chamar WdfPdoInitSetEventCallbacks.

Para obter mais informações sobre essa função de retorno de chamada, consulte Suporte ao wake-up do sistema.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Cabeçalho wdfpdo.h (inclua Wdf.h)
IRQL PASSIVE_LEVEL

Confira também

WdfPdoInitSetEventCallbacks

EvtDeviceDisableWakeAtBus