OID_PM_ADD_WOL_PATTERN

Articolo
06/15/2023

Come set, i driver di protocollo NDIS usano l'OID OID_PM_ADD_WOL_PATTERN per aggiungere un modello di riattivazione LAN di risparmio energia a una scheda di rete. Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_PM_WOL_PATTERN .

Commenti

I driver di protocollo NDIS 6.20 e versioni successive usano OID_PM_ADD_WOL_PATTERN per aggiungere un modello di riattivazione LAN (WOL) a una scheda di rete. La richiesta OID contiene il criterio che la scheda di rete deve confrontare con i pacchetti in ingresso quando si trova in uno stato di alimentazione insufficiente. La scheda di rete deve generare un evento di riattivazione quando riceve un pacchetto che corrisponde ai criteri del criterio.

Un driver di protocollo può aggiungere modelli WOL dopo che è stato associato correttamente a una scheda di rete sottostante e non appena ha i dati necessari (ad esempio l'indirizzo IP dell'interfaccia) per configurare il modello WOL. Il driver di protocollo può anche aggiungere un modello WOL in risposta ad altre notifiche degli eventi di risparmio energia, ad esempio il rifiuto di un modello WOL aggiunto in precedenza o un protocollo offloaded.

Per evitare race condition in NDIS e altri driver di protocollo associati alla stessa scheda miniport, dopo che NDIS inizia a impostare una scheda di rete su uno stato a basso consumo, non riuscirà a qualsiasi tentativo di aggiungere un nuovo modello di riattivazione alla scheda di rete. Ad esempio, se un driver di protocollo NDIS tenta di aggiungere un nuovo modello WOL nel contesto dell'elaborazione di una notifica degli eventi NetEventSetPower per tale scheda di rete, NDIS non riuscirà la richiesta.

Prima che NDIS invii questa richiesta OID ai driver NDIS sottostanti o completi la richiesta al driver overlying, imposta il membro ULONG PatternId della struttura NDIS_PM_WOL_PATTERN su un valore univoco. I driver di protocollo e NDIS usano questo identificatore di modello con la richiesta OID OID_PM_REMOVE_WOL_PATTERN per rimuovere il modello WOL dalla scheda di rete sottostante.

Nota L'identificatore del criterio è un valore univoco per ognuno dei modelli impostati su una scheda di rete. Tuttavia, l'identificatore del modello non è univoco a livello globale in tutte le schede miniport.

Se NDIS o una scheda di rete sottostante rimuove un modello WOL, genera un'indicazione di stato NDIS_STATUS_PM_WOL_PATTERN_REJECTED . Il membro StatusBuffer della struttura NDIS_STATUS_INDICATION contiene l'identificatore del modello WOL ULONG rifiutato.

Il driver miniport restituisce uno dei codici di stato seguenti per la richiesta:

NDIS_STATUS_SUCCESS
Il modello richiesto è stato aggiunto correttamente. Il membro PatternId della struttura NDIS_PM_WOL_PATTERN contiene un identificatore di modello.

NDIS_STATUS_PENDING
La richiesta è in attesa di completamento. NDIS passerà il codice di stato finale e i risultati al gestore di completamento della richiesta OID del chiamante al termine della richiesta.

NDIS_STATUS_PM_WOL_PATTERN_LIST_FULL
La richiesta non è riuscita perché l'elenco dei criteri è pieno e la scheda di rete non può aggiungere un altro modello.

NDIS_STATUS_RESOURCES
NDIS o scheda di rete sottostante non è stato in grado di aggiungere il nuovo modello a causa della mancanza di risorse.

NDIS_STATUS_INVALID_PARAMETER
Uno o più parametri nella struttura NDIS_PM_WOL_PATTERN non sono validi.

NDIS_STATUS_BUFFER_TOO_SHORT
Il buffer delle informazioni era troppo breve. NDIS imposta i DATI. SET_INFORMATION. Membro BytesNeeded nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie.

NDIS_STATUS_NOT_SUPPORTED
La scheda di rete non supporta il modello WOL richiesto.

NDIS_STATUS_FAILURE
La richiesta non è riuscita per motivi diversi dai motivi precedenti.