EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE funzione di callback (netdevice.h)

  • Articolo

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, poiché NetAdapterCx blocca già le origini di riattivazione che non sono 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 della 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 Il 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 di Power Management.

Requisiti

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