Funzionalità di risparmio energia per la creazione di report

I driver Miniport che supportano NDIS 6.20 e versioni successive di NDIS segnalano le funzionalità di risparmio energia hardware durante l'inizializzazione. NDIS segnala le funzionalità correnti per l'overlying dei driver di protocollo NDIS durante l'operazione di associazione. Tuttavia, NDIS può nascondere alcune funzionalità dal driver di protocollo. Ad esempio, NDIS potrebbe segnalare funzionalità diverse quando un utente disabilita alcune o tutte le funzionalità di risparmio energia.

Si noti che le funzionalità di risparmio energia correnti che NDIS segnala a un driver di protocollo non sono necessariamente le stesse delle funzionalità hardware segnalate dal driver miniport a NDIS.

Se un driver miniport NDIS 6.1 o precedente è associato a un driver di protocollo NDIS 6.20, NDIS converte le funzionalità di risparmio energia in un formato supportato dal driver di protocollo NDIS 6.20. NDIS converte anche le funzionalità di risparmio energia che un driver miniport NDIS 6.20 segnala in un formato supportato dai driver NDIS 6.1 e versioni precedenti.

Le funzionalità hardware che un driver miniport segnala possono essere abilitate o disabilitate nelle impostazioni del file INF. Per altre informazioni sulle impostazioni dei file INF per il risparmio energia, vedere Parole chiave INF standardizzate per il risparmio energia.

Durante l'inizializzazione del miniport, un driver miniport inizializza una struttura NDIS_PM_CAPABILITIES con le funzionalità di risparmio energia dell'hardware sottostante. Il driver miniport imposta il membro PowerManagementCapabilitiesEx della struttura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES in modo che punti alla struttura NDIS_PM_CAPABILITIES .

La struttura NDIS_PM_CAPABILITIES include le informazioni seguenti:

Flag
Per NDIS 6.20, questo membro è riservato per NDIS.

A partire da NDIS 6.30, vengono definiti i flag seguenti:

NDIS_PM_WAKE_PACKET_INDICATION_SUPPORTED
Se questo flag è impostato, la scheda di rete può salvare il pacchetto ricevuto che ha causato la generazione di un evento di riattivazione della scheda.

Per altre informazioni su questa funzionalità di risparmio energia, vedere Indicazioni sullo stato della riattivazione NDIS.

NDIS_PM_SELECTIVE_SUSPEND_SUPPORTED
Se questo flag è impostato, il driver miniport supporta la sospensione selettiva NDIS per le schede di rete.

Per altre informazioni su questa funzionalità di risparmio energia, vedere Sospensione selettiva NDIS.

SupportedWoLPacketPatterns
Contiene flag che specificano i modelli di pacchetti di riattivazione LAN (WOL) supportati da una scheda di rete. Ad esempio, la scheda di rete può generare un evento di riattivazione quando riceve una bitmap, un pacchetto magic WOL o un messaggio di identificatore di richiesta EAP su LAN (EAPOL). Per un elenco completo dei modelli supportati nel sistema operativo corrente, vedere la pagina di riferimento NDIS_PM_CAPABILITIES .

NumTotalWoLPatterns
Valore ULONG che contiene il numero totale di modelli WOL supportati da una scheda di rete. Questa è la somma di "numero di modelli di protocollo WOL supportati" e "numero di modelli bitmap WOL supportati".

Ad esempio, se il driver supporta 8 modelli bitmap flessibili, IPv4 TCP SYN (tramite filtro preimpostato) e pacchetti magic, è necessario segnalare 9 in NumTotalWoLPatterns. (8 bitmap + 1 IPv4 TCP SYN = 9)

Nota Il numero totale di modelli WOL non include il modello di riattivazione del pacchetto magic.

Per altre informazioni sui modelli di protocollo WOL, vedere NDIS_PM_WOL_PATTERN.

MaxWoLPatternSize
Contiene il numero massimo di byte che è possibile confrontare con un criterio.

MaxWoLPatternOffset
Contiene il numero di byte in un pacchetto che può essere esaminato, che inizia dall'inizio dell'intestazione MAC.

MaxWoLPacketSaveBuffer
Contiene il numero di byte di un modello di protocollo WOL che un driver miniport può salvare in un buffer e indicare lo stack di driver.

SupportedProtocolOffloads
Contiene flag che specificano le funzionalità di offload del protocollo di risparmio energia supportate da una scheda di rete. I driver Miniport usano questi flag per segnalare le funzionalità di offload del protocollo a basso consumo di una scheda di rete. Ad esempio, la scheda di rete può supportare l'offload ARP IPv4, LPv6 Neighbor Solicitation (NS) o IEEE 802.11 Robust Secure Network (RSN) a 4 vie e handshake a 2 vie. Per un elenco completo degli offload del protocollo supportati nel sistema operativo corrente, vedere la pagina di riferimento NDIS_PM_CAPABILITIES .

NumArpOffloadIPv4Addresses
Contiene il numero di indirizzi IPv4 offload ARP.

NumNSOffloadIPv6Addresses
Contiene il numero di richieste di offload IPv6 di richiesta di richiesta di rete supportate dalla scheda di rete.

MinMagicPacketWakeUp
Specifica lo stato di alimentazione del dispositivo più basso da cui una scheda di rete può 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.

MinPatternWakeUp
Specifica lo stato di alimentazione del dispositivo più basso da cui una scheda di rete può segnalare un evento di riattivazione alla ricezione di un frame di rete che contiene un modello specificato dal driver del protocollo.

MinLinkChangeWakeUp
Specifica lo stato di alimentazione del dispositivo più basso da cui una scheda di rete può segnalare un evento di riattivazione quando si verifica una modifica del collegamento (connessione multimediale o disconnessione).

SupportedWakeUpEvents
Specifica gli eventi di riattivazione indipendenti dai supporti supportati da una scheda di rete. Questi eventi non sono specifici del tipo di supporto. Ad esempio, questi eventi di riattivazione includono eventi di modifica dei collegamenti.

MediaSpecificWakeUpEvents
Specifica gli eventi di riattivazione specifici del supporto supportati da una scheda di rete. Ad esempio, questi eventi includono quanto segue:

• La scheda di rete 802.11 annulla l'associazione con il punto di accesso (AP).

• La scheda di rete mobile broadband (MB) rileva una modifica dello stato di registrazione al servizio MB.

Se un driver miniport supporta l'offload dei protocolli in una scheda di rete in uno stato a basso consumo, deve supportare lo stesso stato di alimentazione insufficiente per l'offload del protocollo supportato per un evento WOL di corrispondenza del modello; ovvero il valore specificato nel membro MinPatternWakeUp o MinMagicPacketWakeUp .

NDIS inizializza una struttura NDIS_PM_CAPABILITIES con le funzionalità di risparmio energia attualmente disponibili della scheda di rete sottostante e la passa al protocollo overlying dei driver di protocollo durante l'operazione di associazione. NDIS imposta il membro PowerManagementCapabilitiesEx della struttura NDIS_BIND_PARAMETERS in modo che punti alla struttura NDIS_PM_CAPABILITIES.

I driver eccessivamente possono usare la query OID OID_PM_HARDWARE_CAPABILITIES per ottenere le funzionalità di risparmio energia hardware della scheda di rete. NDIS gestisce questa richiesta OID per conto del driver miniport. I driver miniport NDIS non sono necessari per supportare la richiesta OID OID_PM_HARDWARE_CAPABILITIES.

I driver overlying possono usare l'OID OID_PM_CURRENT_CAPABILITIES per eseguire query sulle funzionalità di risparmio energia attualmente disponibili di una scheda di rete. NDIS gestisce questa richiesta OID per conto del driver miniport. I driver miniport NDIS non sono necessari per supportare la richiesta OID OID_PM_CURRENT_CAPABILITIES.