Compartilhar via


função de retorno de chamada EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE (netdevice.h)

Implemente esse retorno de chamada opcional para rejeitar padrões de ativação que não são compatíveis com seu hardware.

Sintaxe

EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE EvtNetDevicePreviewWakeSource;

NTSTATUS EvtNetDevicePreviewWakeSource(
  [_In_] WDFDEVICE Device,
  [_In_] NETWAKESOURCE WakeSource
)
{...}

Parâmetros

[_In_] Device

O objeto WDFDEVICE que o driver cliente obteve anteriormente com uma chamada para WdfDeviceCreate.

[_In_] WakeSource

Um objeto NETWAKESOURCE que representa a fonte de ativação a ser examinada.

Retornar valor

Para aceitar o padrão, a função de retorno de chamada deve retornar STATUS_SUCCESS.

Para rejeitar o padrão, retorne STATUS_NDIS_PM_WOL_PATTERN_LIST_FULL.

Comentários

Os drivers não são necessários para implementar EvtNetDevicePreviewWakeSource, pois NetAdapterCx já bloqueia fontes de ativação que não são compatíveis com o NET_ADAPTER_WAKE_BITMAP_CAPABILITIES do driver. No entanto, se o hardware tiver limitações adicionais que não podem ser expressas na estrutura de recursos de bitmap, você poderá fornecer EvtNetDevicePreviewWakeSource para impor essas limitações adicionais.

Registre sua implementação dessa função de retorno de chamada definindo o membro apropriado do NET_DEVICE_POWER_POLICY_EVENT_CALLBACKS e, em seguida, chamando NetDeviceInitSetPowerPolicyEventCallbacks.

Os drivers cliente normalmente chamam NetDeviceInitSetPowerPolicyEventCallbacks ao criar o objeto do dispositivo, antes de chamar WdfDeviceCreate.

Nesse retorno de chamada, os drivers de cliente têm a chance de rejeitar a fonte de ativação. Por exemplo, se o número de filtros de energia na lista de fontes de ativação atual do Dispositivo já tiver atingido ou excedido o número de filtros de energia compatíveis com o hardware, o driver poderá rejeitar essa fonte de ativação.

Para obter mais informações, consulte Configurando o Gerenciamento de Energia.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 2004
Plataforma de Destino Universal
Versão mínima do UMDF 2.33
Cabeçalho netdevice.h (inclua netadaptercx.h)
IRQL PASSIVE_LEVEL