EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE função de retorno de chamada (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.

Valor de retorno

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.

Observações

Os drivers não são necessários para implementar EvtNetDevicePreviewWakeSource, pois o NetAdapterCx já bloqueia fontes de ativação que não são compatíveis com o NET_ADAPTER_WAKE_BITMAP_CAPABILITIESdo 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_CALLBACKSe, em seguida, chamando NetDeviceInitSetPowerPolicyEventCallbacks.

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

Neste retorno de chamada, os drivers 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 Device já tiver atingido ou excedido o número de filtros de energia suportados pelo hardware, o driver poderá rejeitar essa fonte de ativação.

Para obter mais informações, consulte Configuring Power Management.

Requisitos

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