struttura NDIS_PM_PARAMETERS (ntddndis.h)
La struttura NDIS_PM_PARAMETERS specifica le funzionalità hardware correnti o nuove di risparmio energia abilitate per una scheda di rete.
Sintassi
typedef struct _NDIS_PM_PARAMETERS {
NDIS_OBJECT_HEADER Header;
ULONG EnabledWoLPacketPatterns;
ULONG EnabledProtocolOffloads;
ULONG WakeUpFlags;
ULONG MediaSpecificWakeUpEvents;
} NDIS_PM_PARAMETERS, *PNDIS_PM_PARAMETERS;
Members
Header
Tipo, revisione e dimensioni della struttura NDIS_PM_PARAMETERS . Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .
Il driver miniport deve impostare il membro Type di Header su NDIS_OBJECT_TYPE_DEFAULT. Per specificare la versione della struttura NDIS_PM_PARAMETERS , il driver deve impostare il membro Revision di Header sul valore seguente:
NDIS_PM_PARAMETERS_REVISION_2
Sono state aggiunte varie modifiche per NDIS 6.30.
Impostare il membro Size su NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_2.
NDIS_PM_PARAMETERS_REVISION_1
Versione originale per NDIS 6.20.
Impostare il membro Size su NDIS_SIZEOF_NDIS_PM_PARAMETERS_REVISION_1.
EnabledWoLPacketPatterns
Valore ULONG che contiene un OR bit per bit di flag che corrispondono alle funzionalità segnalate dal driver miniport nel membro SupportedWoLPacketPatterns della struttura NDIS_PM_CAPABILITIES . NDIS usa questi flag per abilitare i modelli di riattivazione LAN (WOL) usati da una scheda di rete per riattivare il computer locale da uno stato di alimentazione insufficiente. Per altre informazioni sui modelli WOL, vedere NDIS_PM_WOL_PATTERN.
Vengono usati i flag seguenti:
NDIS_PM_WOL_BITMAP_PATTERN_ENABLED
Se questo flag è impostato, la scheda di rete è abilitata per generare un evento di riattivazione quando riceve un pacchetto che corrisponde a un modello bitmap configurato.
NDIS_PM_WOL_MAGIC_PACKET_ENABLED
Se questo flag è impostato, la scheda di rete è abilitata per generare un evento di riattivazione quando riceve un pacchetto magic WOL. Un pacchetto magic contiene all'interno del payload una stringa di sei byte con un valore di 0xFF, seguito immediatamente da 16 copie contigue dell'indirizzo MAC (Media Access Control) della scheda di rete ricevente.
NDIS_PM_WOL_EAPOL_REQUEST_ID_MESSAGE_ENABLED
Se questo flag è impostato, la scheda di rete è abilitata per generare un evento di riattivazione quando riceve un messaggio di identificatore di richiesta EAPOL.
NDIS_PM_WOL_IPV4_TCP_SYN_ENABLED
Se questo flag è impostato, la scheda di rete è abilitata per generare un evento di riattivazione quando riceve un pacchetto TCP SYN IPv4. Gli host remoti inviano pacchetti TCP SYN per avviare una connessione TCP al computer locale.
NDIS_PM_WOL_IPV6_TCP_SYN_ENABLED
Se questo flag è impostato, la scheda di rete viene abilitata per generare un evento di riattivazione quando riceve un pacchetto TCP SYN IPv6.
NDIS_PM_WOL_IPV4_DEST_ADDR_WILDCARD_ENABLED
Se questo flag è impostato, la scheda di rete deve considerare come valori jolly tutti i valori con riempimento zero o non specificato per gli indirizzi IPv4 e le porte TCP/UDP in un modello WOL. In questo modo, il valore con caratteri jolly corrisponde a qualsiasi indirizzo IPv4 e a qualsiasi valore di porta del pacchetto in ingresso nella posizione specificata dal modello WOL.
Se questo flag è impostato, la scheda di rete è abilitata per generare un evento di riattivazione se sono vere le condizioni di corrispondenza dei criteri seguenti:
- Qualsiasi valore del pacchetto in ingresso nella posizione specificata dal modello WOL è una corrispondenza, se il modello WOL per tale posizione contiene un valore con caratteri jolly.
- Un valore del pacchetto in ingresso nella posizione specificata dal modello WOL è una corrispondenza se il modello WOL per tale posizione contiene un valore diverso da zero che equivale al valore del pacchetto.
Nota
I valori con caratteri jolly abilitati da questo flag possono includere indirizzi di origine e di destinazione IPv4 non specificati, nonché porte di origine e di destinazione non specificate.
NDIS_PM_WOL_IPV6_DEST_ADDR_WILDCARD_ENABLED
Se questo flag è impostato, la scheda di rete deve trattare come valori jolly qualsiasi valore con riempimento zero o non specificato, valori per gli indirizzi IPv6 e le porte TCP/UDP in un modello WOL. In questo modo, il valore con caratteri jolly corrisponde a qualsiasi indirizzo IPv6 e a qualsiasi valore di porta del pacchetto in ingresso nella posizione specificata dal modello WOL.
Se questo flag è impostato, la scheda di rete è abilitata per generare un evento di riattivazione se sono vere le condizioni di corrispondenza dei criteri seguenti:
- Qualsiasi valore del pacchetto in ingresso nella posizione specificata dal modello WOL è una corrispondenza, se il modello WOL per tale posizione contiene un valore con caratteri jolly.
- Un valore del pacchetto in ingresso nella posizione specificata dal modello WOL è una corrispondenza se il modello WOL per tale posizione contiene un valore diverso da zero che equivale al valore del pacchetto.
Nota
I valori con caratteri jolly abilitati da questo flag possono includere indirizzi di origine e destinazione IPv6 non specificati, nonché porte di origine e di destinazione non specificate.
EnabledProtocolOffloads
Valore ULONG che contiene un OR bit per bit di flag che corrispondono alle funzionalità segnalate dal driver miniport nel membro SupportedProtocolOffloads della struttura NDIS_PM_CAPABILITIES . NDIS usa questi flag per abilitare le funzionalità di offload del protocollo a basso consumo in una scheda di rete. Vengono usati i flag seguenti:
NDIS_PM_PROTOCOL_OFFLOAD_ARP_ENABLED
Se questo bit è impostato, il driver overlying richiederà alla scheda di rete di abilitare la funzionalità di offload del protocollo ARP. Non appena questo offload di protocollo è stato configurato da una richiesta set di OID_PM_ADD_PROTOCOL_OFFLOAD, il driver deve consentire alla scheda di rete di rispondere ai pacchetti ARP IPv4 mentre si trova in uno stato a basso consumo.
NDIS_PM_PROTOCOL_OFFLOAD_NS_ENABLED
Se questo bit è impostato, il driver overlying richiederà alla scheda di rete di abilitare la funzionalità di offload del protocollo IPv6 Neighbor Solicitation (NS). Non appena questo offload di protocollo è stato configurato da una richiesta set di OID_PM_ADD_PROTOCOL_OFFLOAD, il driver deve consentire alla scheda di rete di rispondere ai pacchetti NS mentre si trova in uno stato a basso consumo.
NDIS_PM_PROTOCOL_OFFLOAD_80211_RSN_REKEY_ENABLED
Se questo bit è impostato, il driver overlying richiederà la scheda di rete per abilitare la funzionalità di offload del protocollo IEEE 802.11i Robust Security Network (RSN). Non appena questo offload di protocollo è stato configurato da una richiesta set di OID_PM_ADD_PROTOCOL_OFFLOAD, il driver deve consentire alla scheda di rete di rispondere ai pacchetti di richieste di re-key RSN mentre è in uno stato di alimentazione insufficiente.
WakeUpFlags
Valore ULONG che contiene un OR bit per bit di NDIS_PM_WAKE_ON_ xxx flag. NDIS usa questi flag per abilitare le funzionalità di riattivazione in una scheda di rete. Questo membro usa i flag seguenti:
NDIS_PM_WAKE_ON_LINK_CHANGE_ENABLED
Se questo flag è impostato, la scheda di rete viene abilitata per generare un evento di riattivazione quando lo stato del collegamento passa dal supporto disconnesso al supporto connesso.
Per altre informazioni su questa funzionalità WOL, vedere Low Power on Media Disconnect.For more information about this WOL capability, see Low Power on Media Disconnect.
NDIS_PM_WAKE_ON_MEDIA_DISCONNECT_ENABLED
Se questo flag è impostato, la scheda di rete è abilitata per generare un evento di riattivazione quando lo stato del collegamento cambia dal supporto connesso al supporto disconnesso.
NDIS_PM_SELECTIVE_SUSPEND_ENABLED
Se questo flag è impostato, la scheda di rete è abilitata per generare un evento di riattivazione ogni volta che si verifica uno degli eventi seguenti:
- La scheda di rete riceve un pacchetto che corrisponde a un filtro di ricezione pacchetti. L'adattatore viene configurato con questi filtri tramite richieste di set OID di OID_GEN_CURRENT_PACKET_FILTER.
- La scheda di rete rileva altri eventi esterni che richiedono l'elaborazione dallo stack di driver di rete, ad esempio quando lo stato del collegamento cambia in disconnessione multimediale o supporto connesso.
Nota
Il flag NDIS_PM_SELECTIVE_SUSPEND_ENABLED è disponibile in NDIS 6.30 e versioni successive.
Se questo flag è impostato, non è possibile impostare altri flag di risparmio energia nel membro WakeUpFlags e il membro EnabledWoLPacketPatterns deve essere impostato su zero.
Se NDIS imposta il flag NDIS_PM_SELECTIVE_SUSPEND_ENABLED , invia la richiesta del set OID di OID_PM_PARAMETERS direttamente al driver miniport. In questo modo NDIS può ignorare l'elaborazione filtrando i driver nello stack di driver di rete.
Per altre informazioni sulla funzionalità di risparmio energia di sospensione selettiva, vedere Sospensione selettiva NDIS.
MediaSpecificWakeUpEvents
Valore ULONG che contiene un OR bit per bit di flag. Questi flag specificano gli eventi di riattivazione specifici del supporto supportati da una scheda di rete.
A partire da NDIS 6.30, vengono definiti i flag seguenti:
NDIS_WLAN_WAKE_ON_NLO_DISCOVERY_ENABLED
Se questo flag è impostato, la scheda di rete 802.11 è abilitata per generare un evento di riattivazione quando rileva un identificatore del set di servizi (SSID) specificato tramite un offload di rete (NLO).
Per altre informazioni su NLO, vedere Offload dell'elenco reti Wi-Fi.
NDIS_WLAN_WAKE_ON_AP_ASSOCIATION_LOST_ENABLED
Se questo flag è impostato, la scheda di rete 802.11 è abilitata per generare un evento di riattivazione quando si disassocia con il punto di accesso (AP).
NDIS_WLAN_WAKE_ON_GTK_HANDSHAKE_ERROR_ENABLED
Se questo flag è impostato, la scheda di rete 802.11 è abilitata per generare un evento di riattivazione quando si verifica un errore durante l'handshake della chiave temporanea del gruppo RSN IEEE 802.11i con l'API.
NDIS_WLAN_WAKE_ON_4WAY_HANDSHAKE_REQUEST_ENABLED
Se questo flag è impostato, la scheda di rete 802.11 è abilitata per generare un evento di riattivazione quando riceve il primo frame dell'handshake RSN 802.11i RSN a 4 vie con l'API. Questo handshake viene eseguito quando l'adapter esegue l'autenticazione con l'API.
NDIS_WWAN_WAKE_ON_REGISTER_STATE_ENABLED
Se questo flag è impostato, la scheda di rete mobile broadband (MB) è abilitata per generare un evento di riattivazione quando il relativo stato di registrazione al servizio MB è cambiato.
NDIS_WWAN_WAKE_ON_SMS_RECEIVE_ENABLED
Se questo flag è impostato, la scheda di rete MB è abilitata per generare un evento di riattivazione quando il servizio MB deve ricevere una notifica sulla ricezione di un messaggio SMS (Short Message Service). L'adattatore genera questo evento di riattivazione dopo il completamento di una richiesta di query OID_WWAN_SMS_READ precedentemente rilasciata o l'arrivo di un nuovo messaggio di classe-0 (flash/alert) dal provider di rete come notifica degli eventi.
NDIS_WWAN_WAKE_ON_USSD_RECEIVE_ENABLED
Se questo flag è impostato, la scheda di rete MB è abilitata per generare un evento di riattivazione quando riceve un messaggio USSD (Unstructured Supplementari Service Data).
NDIS_WWAN_WAKE_ON_PACKET_STATE_ENABLED
Se questo flag è impostato, la scheda di rete MB è abilitata per generare un evento di riattivazione quando cambia la disponibilità dei dati del pacchetto cellulare. Questo flag è nuovo in Windows 10.
NDIS_WWAN_WAKE_ON_UICC_CHANGE_ENABLED
Se questo flag è impostato, la scheda di rete MB è abilitata per generare un evento di riattivazione quando la scheda UICC (SIM) viene inserita, rimossa o entra in uno stato di errore. Questo flag è nuovo in Windows 10.
Commenti
La struttura NDIS_PM_PARAMETERS specifica le funzionalità hardware di risparmio energia abilitate per l'OID OID_PM_PARAMETERS . Quando viene eseguita una query sull'OID OID_PM_PARAMETERS, questa struttura fornisce la configurazione corrente del risparmio energia. Quando l'OID OID_PM_PARAMETERS è impostato, questa struttura specifica una nuova configurazione di risparmio energia che deve essere utilizzata dalla scheda di rete.
Un driver eccessivamente non deve tentare di abilitare le funzionalità non supportate da una scheda di rete. Per consentire a un driver overlying di determinare le funzionalità offerte da una scheda di rete, NDIS fornisce le funzionalità nel membro PowerManagementCapabilitiesEx della struttura NDIS_BIND_PARAMETERS .
Nota
I driver NDIS 6.20 e versioni successive devono usare il membro PowerManagementCapabilitiesEx della struttura NDIS_BIND_PARAMETERS anziché il membro PowerManagementCapabilities .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato in NDIS 6.20 e versioni successive. |
| Intestazione | ntddndis.h (include Ntddndis.h) |