OID_PNP_ENABLE_WAKE_UP

  • Articolo

Come set, l'OID OID_PNP_ENABLE_WAKE_UP specifica le funzionalità di riattivazione che un driver miniport deve abilitare in una scheda di rete.

Come query, OID_PNP_ENABLE_WAKE_UP ottiene le funzionalità di riattivazione correnti abilitate per una scheda di rete.

Il membro InformationBuffer della struttura NDIS_OID_REQUEST è una maschera bit di flag che può essere usata per abilitare una combinazione di eventi di riattivazione :

NDIS_PNP_WAKE_UP_MAGIC_PACKET
Se impostato, specifica che il driver miniport deve abilitare una scheda di rete per segnalare un evento di riattivazione alla ricezione di un pacchetto magic. Un pacchetto magic è un pacchetto che contiene 16 copie contigue dell'indirizzo Ethernet della scheda di rete ricevente. Se cancellato, specifica che il driver miniport deve disabilitare la scheda di rete da segnalare un evento di riattivazione.

NDIS_PNP_WAKE_UP_PATTERN_MATCH
Se impostato, specifica che il driver miniport deve abilitare una scheda di rete per segnalare un evento di riattivazione della ricezione di un pacchetto contenente un modello specificato dal protocollo con OID_PNP_ADD_WAKE_UP_PATTERN. Se cancellato, specifica che il driver miniport deve disabilitare la scheda di rete da segnalare un evento di riattivazione.

NDIS_PNP_WAKE_UP_LINK_CHANGE
Riservato. NDIS ignora questo flag.

Un driver di protocollo usa le funzionalità di riattivazione della scheda di rete in NDIS_BIND_PARAMETERS per abilitare le funzionalità di riattivazione della scheda di rete associate. Un driver di protocollo può anche eseguire query su questo OID per determinare quali funzionalità di riattivazione sono abilitate per una scheda di rete.

NDIS non abilita immediatamente le funzionalità di riattivazione specificate da un driver di protocollo. NDIS tiene invece traccia delle funzionalità di riattivazione abilitate dal driver del protocollo e, subito prima che la scheda di rete passi a uno stato a bassa potenza, NDIS invia una richiesta OID_PNP_ENABLE_WAKE_UP impostata sul driver miniport per abilitare gli eventi di riattivazione appropriati.

Prima che la scheda di rete passi a uno stato a bassa potenza, ovvero prima che NDIS invii il driver miniport una richiesta di OID_PNP_SET_POWER ), NDIS invia il driver miniport a una richiesta di OID_PNP_ENABLE_WAKE_UP per abilitare le funzionalità di riattivazione appropriate.

Il driver miniport deve eseguire i passaggi appropriati dipendenti dal dispositivo per abilitare o disabilitare gli eventi di riattivazione nella scheda di rete.

Il driver miniport deve cancellare le funzionalità di riattivazione impostate da NDIS con OID_PNP_ENABLE_WAKE_UP quando il sistema viene ripreso. Le funzionalità di riattivazione non devono essere mantenute tra i riprendi. Se le funzionalità di riattivazione sono abilitate, NDIS imposta in modo esplicito OID_PNP_ENABLE_WAKE_UP prima della transizione del miniport allo stato a bassa potenza.

Un driver intermedio in cui il bordo superiore riceve questa richiesta OID deve sempre propagare la richiesta al driver miniport sottostante chiamando la funzione NdisOidRequest o NdisCoOidRequest.

Requisiti

Versione

Supportato in NDIS 6.0 e 6.1. Per NDIS 6.20 e versioni successive , usare OID_PM_PARAMETERS invece.

Intestazione

 Ntddndis.h (include Ndis.h)

Vedi anche

NDIS_BIND_PARAMETERS

NDIS_OID_REQUEST

NdisCoOidRequest

NdisOidRequest

OID_PM_PARAMETERS

OID_PNP_ADD_WAKE_UP_PATTERN