OID_PNP_ENABLE_WAKE_UP
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 di 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 consentire a una scheda di rete di segnalare un evento di riattivazione alla ricezione di un pacchetto magic. Un pacchetto magic è un pacchetto contenente 16 copie contigue dell'indirizzo Ethernet della scheda di rete ricevente. Se deselezionato, specifica che il driver miniport deve disabilitare la scheda di rete segnalando un evento di riattivazione di questo tipo.
NDIS_PNP_WAKE_UP_PATTERN_MATCH
Se impostato, specifica che il driver miniport deve consentire a una scheda di rete di segnalare un evento di riattivazione alla ricezione di un pacchetto contenente un modello specificato dal protocollo con OID_PNP_ADD_WAKE_UP_PATTERN. Se deselezionato, specifica che il driver miniport deve disabilitare la scheda di rete segnalando un evento di riattivazione di questo tipo.
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 associata. Un driver di protocollo può anche eseguire una 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 di protocollo e, subito prima che la scheda di rete passi a uno stato a basso consumo, NDIS invia una richiesta di OID_PNP_ENABLE_WAKE_UP set al driver miniport per abilitare gli eventi di riattivazione appropriati.
Prima che la scheda di rete passi a uno stato a basso consumo ,ovvero prima che NDIS invii il driver miniport una richiesta di OID_PNP_SET_POWER), NDIS invia al driver miniport 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 che il miniport passi allo stato a basso consumo.
Un driver intermedio in cui il bordo superiore riceve questa richiesta OID deve sempre propagare la richiesta al driver miniport sottostante chiamando il NdisOidRequest o NdisCoOidRequest funzione.
Fabbisogno
Versione |
Supportato in NDIS 6.0 e 6.1. Per NDIS 6.20 e versioni successive, usare invece OID_PM_PARAMETERS). |
Intestazione |
Ntddndis.h (include Ndis.h) |