Parole chiave INF standardizzate per la sospensione selettiva NDIS

Nota

Le parole chiave correlate alla sospensione selettiva sono destinate solo al driver miniport NDIS tradizionale. Sono deprecate nell'estensione della classe WDF della scheda di rete (NetAdapterCx) e non devono essere usate dai relativi driver client.

Le parole chiave INF standardizzate seguenti sono definite per abilitare, disabilitare e configurare i parametri per la sospensione selettiva NDIS in un driver miniport:

*SelectiveSuspend Parola chiave INF

*SSIdleTimeout Parola chiave INF

*SSIdleTimeoutScreenOff Parola chiave INF

Per altre informazioni sulle parole chiave INF standardizzate, vedere Parole chiave INF standardizzate per i dispositivi di rete.

*Parola chiave INF selectiveSuspend

Il file INF per il driver miniport che supporta la sospensione selettiva NDIS deve specificare la parola chiave INF *SelectiveSuspend standardizzata. Dopo aver installato il driver, gli amministratori possono aggiornare il valore della parola chiave *SelectiveSuspend nella pagina delle proprietà Avanzate per la scheda di rete. Per altre informazioni sulle proprietà avanzate, vedere Specifica dei parametri di configurazione per la pagina Proprietà avanzate.

Nota Il driver miniport viene riavviato automaticamente dopo aver apportato una modifica nella pagina delle proprietà Avanzate per l'adattatore.

La parola chiave *SelectiveSuspend INF è una parola chiave di enumerazione. Nella tabella seguente vengono descritte le possibili voci INF per la parola chiave INF *SelectiveSuspend . Le colonne di questa tabella descrivono gli attributi seguenti per una parola chiave di enumerazione:

SubkeyName
Nome della parola chiave che è necessario specificare nel file INF. Questo nome viene visualizzato anche nel Registro di sistema sotto la chiave NDI\params\ per la scheda di rete.

ParamDesc
Testo visualizzato associato a SubkeyName.

Nota Il fornitore hardware indipendente (IHV) può definire qualsiasi testo descrittivo per SubkeyName.

Valore
Valore intero dell'enumerazione associato a ogni SubkeyName nell'elenco.

EnumDesc
Testo visualizzato associato a ogni valore visualizzato nella pagina delle proprietà Avanzate .

SubkeyName ParamDesc Valore EnumDesc

*SelectiveSuspend

Sospensione selettiva

0

Disabled

1 (impostazione predefinita)

Attivato

Il driver miniport deve controllare il valore della parola chiave *SelectiveSuspend nel Registro di sistema prima di annunciare il supporto per la sospensione selettiva NDIS. Se la parola chiave *SelectiveSuspend ha un valore pari a zero, il miniport non deve annunciare il supporto per le funzionalità di sospensione selettiva. Per altre informazioni, vedere Reporting NDIS Selective Suspend Capabilities.For more information, see Reporting NDIS Selective Suspend Capabilities.

*Parola chiave INF SSIdleTimeout

Il file INF per il driver miniport che supporta la sospensione selettiva NDIS deve specificare la parola chiave INF standard *SSIdleTimeout facoltativa. Questa parola chiave specifica il periodo di timeout di inattività in unità di secondi. Se NDIS non rileva alcuna attività nella scheda di rete per un periodo che supera il valore *SSIdleTimeout , NDIS avvia un'operazione di sospensione selettiva chiamando la funzione del gestore MiniportIdleNotification del driver miniport .

Dopo aver installato il driver, gli amministratori possono aggiornare il valore della parola chiave *SSIdleTimeout nella pagina delle proprietà Avanzate per la scheda di rete. Per altre informazioni sulle proprietà avanzate, vedere Specifica dei parametri di configurazione per la pagina Proprietà avanzate.

Nota Il driver miniport viene riavviato automaticamente dopo aver apportato una modifica nella pagina delle proprietà avanzate per l'adattatore.

La parola chiave *SSIdleTimeout INF è una parola chiave numerica (Int). Nella tabella seguente vengono descritte le possibili voci INF per la parola chiave *SSIdleTimeout INF. Le colonne nella tabella descrivono gli attributi seguenti per una parola chiave Int :

SubkeyName
Nome della parola chiave che è necessario specificare nel file INF. Questo nome viene visualizzato anche nel Registro di sistema sotto la chiave NDI\params\ per la scheda di rete.

ParamDesc
Testo visualizzato associato a SubkeyName.

Nota Il fornitore hardware indipendente (IHV) può definire qualsiasi testo descrittivo per SubkeyName.

Valore predefinito
Valore predefinito per l'intero.

Valore minimo
Valore minimo consentito per un numero intero.

Valore massimo
Valore massimo consentito per un numero intero.

SubkeyName ParamDesc Valore predefinito Valore minimo Valore massimo

*SSIdleTimeout

Timeout di inattività selettivo sospeso in unità di secondi

5

1

60

Nota NDIS legge il valore della parola chiave INF standardizzata *SSIdleTimeout per ogni istanza della scheda di rete il cui driver supporta la sospensione selettiva NDIS. I driver Miniport non devono leggere questa parola chiave.

NDIS misura il timeout di inattività usando timer precisi entro il 30% del valore *SSIdleTimeout . Ad esempio, se il valore *SSIdleTimeout è 10, l'adattatore viene sospeso tra 10 e 13 secondi dopo che NDIS rileva prima che l'adattatore sia inattiva.

*Parola chiave INF *SSIdleTimeoutScreenOff

Il file INF per il driver miniport che supporta la sospensione selettiva NDIS deve specificare la parola chiave facoltativa *SSIdleTimeoutScreenOff standardizzata INF. Questa parola chiave specifica il periodo di timeout di inattività in unità di secondi ed è applicabile solo quando lo schermo è disattivato. Se NDIS non rileva alcuna attività nella scheda di rete per un periodo che supera il valore *SSIdleTimeoutScreenOff dopo la disattivazione dello schermo, NDIS avvia un'operazione di sospensione selettiva chiamando la funzione del gestore MiniportIdleNotification del driver miniport .

Dopo aver installato il driver, gli amministratori possono aggiornare il valore della parola chiave *SSIdleTimeoutScreenOff nella pagina delle proprietà Avanzate per la scheda di rete. Per altre informazioni sulle proprietà avanzate, vedere Specifica dei parametri di configurazione per la pagina Proprietà avanzate.

Nota Il driver miniport viene riavviato automaticamente dopo aver apportato una modifica nella pagina delle proprietà avanzate per l'adattatore.

La parola chiave *SSIdleTimeoutScreenOff INF è una parola chiave numerica (Int). Nella tabella seguente vengono descritte le possibili voci INF per la parola chiave *SSIdleTimeoutScreenOff INF. Le colonne nella tabella descrivono gli attributi seguenti per una parola chiave Int :

SubkeyName
Nome della parola chiave che è necessario specificare nel file INF. Questo nome viene visualizzato anche nel Registro di sistema sotto la chiave NDI\params\ per la scheda di rete.

ParamDesc
Testo visualizzato associato a SubkeyName.

Nota Il fornitore hardware indipendente (IHV) può definire qualsiasi testo descrittivo per SubkeyName.

Valore predefinito
Valore predefinito per l'intero.

Valore minimo
Valore minimo consentito per un numero intero.

Valore massimo
Valore massimo consentito per un numero intero.

SubkeyName ParamDesc Valore predefinito Valore minimo Valore massimo

*SSIdleTimeoutScreenOff

Timeout di inattività selettivo sospeso in unità di secondi

3

1

60

Nota NDIS legge il valore della parola chiave *SSIdleTimeoutScreenOff standardizzata INF per ogni istanza della scheda di rete il cui driver supporta la sospensione selettiva NDIS. I driver Miniport non devono leggere questa parola chiave.

Nota Il valore massimo è solo a scopo di test. Il test di certificazione HLK verificherà in modo esplicito e avrà esito negativo se il valore è maggiore di 5.

NDIS misura il timeout di inattività usando timer precisi entro il 30% del valore *SSIdleTimeoutScreenOff . Ad esempio, se il valore *SSIdleTimeoutScreenOff è 5, l'adattatore viene sospeso tra 5 e 6,5 secondi dopo che NDIS rileva prima che l'adattatore sia inattiva.