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.

Commenti

I driver non sono necessari per implementare EvtNetDevicePreviewWakeSource, perché NetAdapterCx blocca già le origini di riattivazione non compatibili con il NET_ADAPTER_WAKE_BITMAP_CAPABILITIES del driver. 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 in genere chiamano NetDeviceInitSetPowerPolicyEventCallbacks durante la creazione dell'oggetto dispositivo, prima di chiamare WdfDeviceCreate.

In questo callback, i driver client hanno la possibilità di rifiutare l'origine di riattivazione. Ad esempio, se il numero di filtri di alimentazione nell'elenco di origine della riattivazione corrente per Dispositivo ha già 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 del risparmio energia.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10, versione 2004
Piattaforma di destinazione	Universale
Versione UMDF minima	2.33
Intestazione	netdevice.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL