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