Gestandaardiseerde INF-trefwoorden voor NDIS Selectieve onderbreking

Notitie

Selectieve Onderbreking gerelateerde trefwoorden zijn alleen bedoeld voor traditionele NDIS-miniportstuurprogramma's. Ze worden afgeschaft in WDF Class Extension (NetAdapterCx) en mogen niet worden gebruikt door de clientstuurprogramma's.

De volgende gestandaardiseerde INF-trefwoorden zijn gedefinieerd om parameters voor NDIS Selectieve Onderbreking in een minipoortstuurprogramma in te schakelen, uit te schakelen en te configureren.

*SelectiveSuspend INF-trefwoorden

*SSIdleTimeout INF-trefwoord

*SSIdleTimeoutScreenOff INF-trefwoord

Zie Gestandaardiseerde INF-trefwoorden voor netwerkapparatenvoor meer informatie over gestandaardiseerde INF-trefwoorden.

*SelectiveSuspend INF-zoekwoord

Het INF-bestand voor het minipoortstuurprogramma dat NDIS selectieve onderbreking ondersteunt, moet het *SelectiveSuspend gestandaardiseerde INF-trefwoord opgeven. Nadat het stuurprogramma is geïnstalleerd, kunnen beheerders de *SelectiveSuspend trefwoordwaarde bijwerken op de eigenschappenpagina Geavanceerd voor de netwerkadapter. Zie Configuratieparameters opgeven voor de pagina Geavanceerde eigenschappenvoor meer informatie over geavanceerde eigenschappen.

Opmerking Het minipoortstuurprogramma wordt automatisch opnieuw opgestart nadat een wijziging is aangebracht op de eigenschappenpagina Geavanceerd voor de adapter.

Het *SelectiveSuspend INF-trefwoord is een opsommingstrefwoord. In de volgende tabel worden de mogelijke INF-vermeldingen voor de *SelectiveSuspend INF-trefwoord beschreven. De kolommen in deze tabel beschrijven de volgende kenmerken voor een opsommingstrefwoord:

SubkeyName
De naam van het trefwoord dat u moet opgeven in het INF-bestand. Deze naam wordt ook weergegeven in het register onder de NDI\params\ sleutel voor de netwerkadapter.

ParamDesc
De weergavetekst die is gekoppeld aan SubkeyName.

Opmerking De onafhankelijke hardwareleverancier (IHV) kan elke beschrijvende tekst voor de SubkeyName definiëren.

Waarde
De opsommingswaarde voor een geheel getal dat is gekoppeld aan elke SubkeyName in de lijst.

EnumDesc
De weergavetekst die is gekoppeld aan elke waarde die wordt weergegeven op de eigenschappenpagina Geavanceerd.

SubkeyName	ParamDesc	Waarde	EnumDesc
*SelectiveSuspend	Selectief onderbreken	0	Uitgeschakeld
		1 (standaard)	Ingeschakeld

Het minipoortstuurprogramma moet de *SelectiveSuspend trefwoordwaarde in het register controleren voordat het bekend maakt dat het NDIS selectief onderbreken ondersteunt. Als de *SelectiveSuspend trefwoord een waarde van nul heeft, mag de minipoort geen ondersteuning voor selectieve onderbrekingsmogelijkheden adverteren. Zie Reporting NDIS Selective Suspend Capabilitiesvoor meer informatie.

*SSIdleTimeout INF-trefwoord

Het INF-bestand voor het minipoortstuurprogramma dat de selectieve onderbreking van NDIS ondersteunt, moet het gestandaardiseerde INF-trefwoord *SSIdleTimeout als optioneel specificeren. Dit trefwoord geeft de time-outperiode voor inactiviteit op in eenheden van seconden. Als NDIS geen activiteit op de netwerkadapter detecteert gedurende een periode die de *SSIdleTimeout waarde overschrijdt, start NDIS een selectieve onderbrekingsbewerking door de MiniportIdleNotification handler-functie van het minipoortstuurprogramma aan te roepen.

Nadat het stuurprogramma is geïnstalleerd, kunnen beheerders de *SSIdleTimeout trefwoordwaarde bijwerken op de eigenschappenpagina Geavanceerd voor de netwerkadapter. Zie Configuratieparameters opgeven voor de pagina Geavanceerde eigenschappenvoor meer informatie over geavanceerde eigenschappen.

Opmerking Het minipoortstuurprogramma wordt automatisch opnieuw opgestart nadat een wijziging is aangebracht op de pagina geavanceerde eigenschappen voor de adapter.

Het *SSIdleTimeout INF-trefwoord is een numeriek (Int) trefwoord. In de volgende tabel worden de mogelijke INF-vermeldingen voor de *SSIdleTimeout INF-trefwoord beschreven. De kolommen in de tabel beschrijven de volgende kenmerken voor een int-trefwoord:

SubkeyName
De naam van het trefwoord dat u moet opgeven in het INF-bestand. Deze naam wordt ook weergegeven in het register onder de NDI\params\ sleutel voor de netwerkadapter.

ParamDesc
De weergavetekst die is gekoppeld aan SubkeyName.

Opmerking De onafhankelijke hardwareleverancier (IHV) kan elke beschrijvende tekst voor de SubkeyName definiëren.

standaardwaarde
De standaardwaarde voor het gehele getal.

Minimumwaarde
De minimumwaarde die is toegestaan voor een geheel getal.

maximumwaarde
De maximumwaarde die is toegestaan voor een geheel getal.

SubkeyName	ParamDesc	Standaardwaarde	Minimumwaarde	Maximumwaarde
*SSIdleTimeout	Time-out voor inactiviteit selectief onderbreken in seconden	5	1	60

Opmerking NDIS leest de waarde van de *SSIdleTimeout gestandaardiseerd INF-trefwoord voor elk exemplaar van de netwerkadapter waarvan het stuurprogramma NDIS selectief onderbreken ondersteunt. Miniportstuurprogramma's mogen dit trefwoord niet lezen.

NDIS meet de time-out voor inactiviteit met behulp van timers die precies zijn ingesteld op binnen 30 procent van de *SSIdleTimeout waarde. Als de *SSIdleTimeout-waarde bijvoorbeeld 10 is, wordt de adapter tussen 10 en 13 seconden onderbroken nadat NDIS de adapter voor het eerst inactief detecteert.

*SSIdleTimeoutScreenOff INF-trefwoord

Het INF-bestand voor het minipoortstuurprogramma dat NDIS selectieve onderbreking ondersteunt, moet het optionele gestandaardiseerde INF-trefwoord *SSIdleTimeoutScreenOff opgeven. Dit trefwoord geeft de time-outperiode voor inactiviteit op in eenheden van seconden en is alleen van toepassing wanneer het scherm is uitgeschakeld. Als NDIS geen activiteit op de netwerkadapter detecteert gedurende een periode die langer duurt dan de *SSIdleTimeoutScreenOff waarde nadat het scherm is uitgeschakeld, start NDIS een selectieve suspend-operatie door de MiniportIdleNotification handler-functie van het minipoortstuurprogramma aan te roepen.

Nadat het stuurprogramma is geïnstalleerd, kunnen beheerders de *SSIdleTimeoutScreenOff trefwoordwaarde bijwerken op de eigenschappenpagina Advanced voor de netwerkadapter. Zie Configuratieparameters opgeven voor de pagina Geavanceerde eigenschappenvoor meer informatie over geavanceerde eigenschappen.

Opmerking Het minipoortstuurprogramma wordt automatisch opnieuw opgestart nadat een wijziging is aangebracht op de pagina geavanceerde eigenschappen voor de adapter.

Het *SSIdleTimeoutScreenOff INF-trefwoord is een numeriek (Int) trefwoord. In de volgende tabel worden de mogelijke INF-vermeldingen voor het trefwoord *SSIdleTimeoutScreenOff INF beschreven. De kolommen in de tabel beschrijven de volgende kenmerken voor een int trefwoord:

SubkeyName
De naam van het trefwoord dat u moet opgeven in het INF-bestand. Deze naam wordt ook weergegeven in het register onder de NDI\params\ sleutel voor de netwerkadapter.

ParamDesc
De weergavetekst die is gekoppeld aan SubkeyName.

Opmerking De onafhankelijke hardwareleverancier (IHV) kan elke beschrijvende tekst voor de SubkeyName definiëren.

standaardwaarde
De standaardwaarde voor het gehele getal.

Minimumwaarde
De minimumwaarde die is toegestaan voor een geheel getal.

maximumwaarde
De maximumwaarde die is toegestaan voor een geheel getal.

SubkeyName	ParamDesc	Standaardwaarde	Minimumwaarde	Maximumwaarde
*SSIdleTimeoutScreenOff	Time-out voor inactiviteit selectief onderbreken in seconden	3	1	60

Opmerking NDIS leest de waarde van het *SSIdleTimeoutScreenOff gestandaardiseerde INF-trefwoord voor elk exemplaar van de netwerkadapter waarvan het stuurprogramma NDIS selectief onderbreken ondersteunt. Miniportstuurprogramma's mogen dit trefwoord niet lezen.

Opmerking De maximumwaarde is alleen bedoeld voor testdoeleinden. De HLK-certificeringstest controleert expliciet en mislukt als de waarde groter is dan 5.

NDIS meet de time-out voor inactiviteit met behulp van timers die precies zijn tot binnen 30 procent van de *SSIdleTimeoutScreenOff waarde. Als de *SSIdleTimeoutScreenOff waarde bijvoorbeeld 5 is, wordt de adapter tussen 5 en 6,5 seconden onderbroken nadat NDIS de adapter eerst inactief detecteert.