EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE funzione di callback (netdevice.h)

Implementare questo callback facoltativo per rifiutare i modelli di riattivazione non compatibili con l'hardware.

Sintassi

EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE EvtNetDevicePreviewWakeSource;

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

Parametri

[_In_] Device

Oggetto WDFDEVICE ottenuto in precedenza dal driver client con una chiamata a WdfDeviceCreate.

[_In_] WakeSource

Oggetto NETWAKESOURCE che rappresenta l'origine di riattivazione da esaminare.

Valore restituito

Per accettare il modello, la funzione di callback deve restituire STATUS_SUCCESS.

Per rifiutare il modello, restituire STATUS_NDIS_PM_WOL_PATTERN_LIST_FULL.

Osservazioni

I driver non sono necessari per implementare EvtNetDevicePreviewWakeSource, perché NetAdapterCx blocca già le origini di riattivazione non compatibili con il driver NET_ADAPTER_WAKE_BITMAP_CAPABILITIES. Tuttavia, se l'hardware presenta limitazioni aggiuntive che non possono essere espresse nella struttura delle funzionalità bitmap, è possibile fornire EvtNetDevicePreviewWakeSource per applicare tali limitazioni aggiuntive.

Registrare l'implementazione di questa funzione di callback impostando il membro appropriato del NET_DEVICE_POWER_POLICY_EVENT_CALLBACKS, quindi chiamando NetDeviceInitSetPowerPolicyEventCallbacks.

I driver client chiamano in genere NetDeviceInitSetPowerPolicyEventCallbacks durante la creazione dell'oggetto dispositivo, prima di chiamare WdfDeviceCreate.

In questo callback, i driver client ottengono la possibilità di rifiutare l'origine di riattivazione. Ad esempio, se il numero di filtri di alimentazione nell'elenco di origine di riattivazione corrente per dispositivo è già stato raggiunto o superato il numero di filtri di alimentazione supportati dall'hardware, il driver può rifiutare questa origine di riattivazione.

Per altre informazioni, vedere Configurazione di Power Management.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10, versione 2004
piattaforma di destinazione	Universale
versione minima di UMDF	2.33
intestazione	netdevice.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL