Mots clés INF standardisés pour la suspension sélective NDIS

Notes

Les mots clés liés à l’interruption sélective sont destinés uniquement à l’utilisation traditionnelle du pilote miniport NDIS. Ils sont déconseillés dans l’extension de classe WDF de la carte réseau (NetAdapterCx) et ne doivent pas être utilisés par ses pilotes clients.

Les mots clés INF standardisés suivants sont définis pour activer, désactiver et configurer les paramètres de la suspension sélective NDIS sur un pilote miniport :

*SelectiveSuspend Mot clé INF

*SSIdleTimeout Mot clé INF

*SSIdleTimeoutScreenOff Mot clé INF

Pour plus d’informations sur les mots clés INF standardisés, consultez Mots clés INF standardisés pour les appareils réseau.

*Mot clé INF SelectiveSuspend

Le fichier INF du pilote miniport qui prend en charge la suspension sélective NDIS doit spécifier le *SelectiveSuspend standard INF mot clé. Une fois le pilote installé, les administrateurs peuvent mettre à jour la valeur *SelectiveSuspend mot clé dans la page de propriétés Avancé de la carte réseau. Pour plus d’informations sur les propriétés avancées, consultez Spécification des paramètres de configuration pour la page Propriétés avancées.

Note Le pilote miniport est automatiquement redémarré après qu’une modification a été apportée dans la page de propriétés Avancé de l’adaptateur.

L’mot clé INF *SelectiveSuspend est une mot clé d’énumération. Le tableau suivant décrit les entrées INF possibles pour le *SelectiveSuspend INF mot clé. Les colonnes de ce tableau décrivent les attributs suivants pour une énumération mot clé :

Nom de sous-clé
Nom du mot clé que vous devez spécifier dans le fichier INF. Ce nom apparaît également dans le Registre sous la clé NDI\params\ de la carte réseau.

ParamDesc
Texte d’affichage associé à SubkeyName.

Note Le fournisseur de matériel indépendant (IHV) peut définir n’importe quel texte descriptif pour le sous-nom de clé.

Valeur
Valeur entière d’énumération associée à chaque sous-nom de clé dans la liste.

EnumDesc
Texte d’affichage associé à chaque valeur qui apparaît dans la page de propriétés Avancées .

Nom de sous-clé ParamDesc Valeur EnumDesc

*SelectiveSuspend

Suspension sélective

0

Désactivé

1 (par défaut)

activé

Le pilote miniport doit case activée la valeur *SelectiveSuspend mot clé dans le Registre avant de publier sa prise en charge de la suspension sélective NDIS. Si le *SelectiveSuspend mot clé a la valeur zéro, le miniport ne doit pas annoncer la prise en charge des fonctionnalités de suspension sélective. Pour plus d’informations, consultez Création de rapports sur les fonctionnalités de suspension sélective NDIS.

*Mot clé INF SSIdleTimeout

Le fichier INF du pilote miniport qui prend en charge la suspension sélective NDIS doit spécifier le mot clé INF standardisé *SSIdleTimeout facultatif. Cette mot clé spécifie le délai d’inactivité en unités de secondes. Si NDIS ne détecte aucune activité sur la carte réseau pendant une période qui dépasse la valeur *SSIdleTimeout , NDIS démarre une opération de suspension sélective en appelant la fonction de gestionnaire MiniportIdleNotification du pilote miniport .

Une fois le pilote installé, les administrateurs peuvent mettre à jour la valeur *SSIdleTimeout mot clé dans la page de propriétés Avancé de la carte réseau. Pour plus d’informations sur les propriétés avancées, consultez Spécification des paramètres de configuration pour la page Propriétés avancées.

Note Le pilote miniport est automatiquement redémarré une fois qu’une modification est apportée dans la page de propriétés avancées de l’adaptateur.

Le *SSIdleTimeout INF mot clé est un mot clé numérique (Int). Le tableau suivant décrit les entrées INF possibles pour le mot clé INF *SSIdleTimeout. Les colonnes de la table décrivent les attributs suivants pour un mot clé Int :

Nom de sous-clé
Nom du mot clé que vous devez spécifier dans le fichier INF. Ce nom apparaît également dans le Registre sous la clé NDI\params\ de la carte réseau.

ParamDesc
Texte d’affichage associé à SubkeyName.

Note Le fournisseur de matériel indépendant (IHV) peut définir n’importe quel texte descriptif pour le sous-nom de clé.

Valeur par défaut
Valeur par défaut de l’entier.

Valeur minimale
Valeur minimale autorisée pour un entier.

Valeur maximale
Valeur maximale autorisée pour un entier.

Nom de sous-clé ParamDesc Valeur par défaut Valeur minimale Valeur maximale

*SSIdleTimeout

Délai d’inactivité de suspension sélective en unités de secondes

5

1

60

Note NDIS lit la valeur du *SSIdleTimeout mot clé INF standardisé pour chaque instance de la carte réseau dont le pilote prend en charge la suspension sélective NDIS. Les pilotes miniport ne doivent pas lire cette mot clé.

NDIS mesure le délai d’inactivité à l’aide de minuteurs précis à 30 % de la valeur *SSIdleTimeout . Par exemple, si la valeur *SSIdleTimeout est 10, l’adaptateur est suspendu entre 10 et 13 secondes après que NDIS a détecté pour la première fois que l’adaptateur est inactif.

*Mot clé INF SSIdleTimeoutScreenOff

Le fichier INF du pilote miniport qui prend en charge la suspension sélective NDIS doit spécifier le mot clé INF standardisé *SSIdleTimeoutScreenOff. Cette mot clé spécifie le délai d’inactivité en unités de secondes et s’applique uniquement lorsque l’écran est éteint. Si NDIS ne détecte aucune activité sur la carte réseau pendant une période qui dépasse la valeur *SSIdleTimeoutScreenOff une fois l’écran désactivé, NDIS démarre une opération de suspension sélective en appelant la fonction de gestionnaire MiniportIdleNotification du pilote miniport .

Une fois le pilote installé, les administrateurs peuvent mettre à jour la valeur *SSIdleTimeoutScreenOff mot clé dans la page de propriétés Avancé de la carte réseau. Pour plus d’informations sur les propriétés avancées, consultez Spécification des paramètres de configuration pour la page Propriétés avancées.

Note Le pilote miniport est automatiquement redémarré une fois qu’une modification est apportée dans la page de propriétés avancées de l’adaptateur.

Le mot clé INF *SSIdleTimeoutScreenOff est un mot clé numérique (Int). Le tableau suivant décrit les entrées INF possibles pour l’mot clé INF *SSIdleTimeoutScreenOff. Les colonnes de la table décrivent les attributs suivants pour un mot clé Int :

Nom de sous-clé
Nom du mot clé que vous devez spécifier dans le fichier INF. Ce nom apparaît également dans le Registre sous la clé NDI\params\ de la carte réseau.

ParamDesc
Texte d’affichage associé à SubkeyName.

Note Le fournisseur de matériel indépendant (IHV) peut définir n’importe quel texte descriptif pour le sous-nom de clé.

Valeur par défaut
Valeur par défaut de l’entier.

Valeur minimale
Valeur minimale autorisée pour un entier.

Valeur maximale
Valeur maximale autorisée pour un entier.

Nom de sous-clé ParamDesc Valeur par défaut Valeur minimale Valeur maximale

*SSIdleTimeoutScreenOff

Délai d’inactivité de suspension sélective en unités de secondes

3

1

60

Note NDIS lit la valeur du mot clé INF standardisé *SSIdleTimeoutScreenOff pour chaque instance de la carte réseau dont le pilote prend en charge la suspension sélective NDIS. Les pilotes miniport ne doivent pas lire cette mot clé.

Note La valeur maximale est uniquement à des fins de test. Le test de certification HLK case activée explicitement et échoue si la valeur est supérieure à 5.

NDIS mesure le délai d’inactivité à l’aide de minuteurs précis à 30 % de la valeur *SSIdleTimeoutScreenOff . Par exemple, si la valeur *SSIdleTimeoutScreenOff est 5, l’adaptateur est suspendu entre 5 et 6,5 secondes après que NDIS a détecté que l’adaptateur est inactif.