Palabras clave INF estandarizadas para suspensión selectiva de NDIS

Nota:

Las palabras clave relacionadas con la suspensión selectiva son solo para el uso tradicional del controlador de miniporte NDIS. Están en desuso en la extensión de clase WDF del adaptador de red (NetAdapterCx) y no los deben usar sus controladores de cliente.

Las siguientes palabras clave INF estandarizadas se definen para habilitar, deshabilitar y configurar parámetros para la suspensión selectiva de NDIS en un controlador de minipuerto:

*SelectiveSuspend Palabra clave INF

*SSIdleTimeout Palabra clave INF

*SSIdleTimeoutScreenOff Palabra clave INF

Para obtener más información sobre las palabras clave INF estandarizadas, vea Palabras clave INF estandarizadas para dispositivos de red.

*Palabra clave INF SelectiveSuspend

El archivo INF para el controlador de minipuerto que admite la suspensión selectiva de NDIS debe especificar la palabra clave INF estandarizada *SelectiveSuspend . Una vez instalado el controlador, los administradores pueden actualizar el valor de palabra clave *SelectiveSuspend en la página de propiedades Avanzadas del adaptador de red. Para obtener más información sobre las propiedades avanzadas, vea Especificar parámetros de configuración para la página Propiedades avanzadas.

Nota El controlador de minipuerto se reinicia automáticamente después de realizar un cambio en la página de propiedades Avanzadas del adaptador.

La palabra clave *SelectiveSuspend INF es una palabra clave de enumeración. En la tabla siguiente se describen las posibles entradas INF para la palabra clave *SelectiveSuspend INF. Las columnas de esta tabla describen los siguientes atributos para una palabra clave de enumeración:

SubkeyName
Nombre de la palabra clave que debe especificar en el archivo INF. Este nombre también aparece en el Registro bajo la clave NDI\params\ del adaptador de red.

ParamDesc
Texto para mostrar asociado a SubkeyName.

Nota El proveedor de hardware independiente (IHV) puede definir cualquier texto descriptivo para SubkeyName.

Valor
Valor entero de enumeración asociado a cada SubkeyName de la lista.

EnumDesc
Texto para mostrar asociado a cada valor que aparece en la página de propiedades Avanzadas .

SubkeyName	ParamDesc	Valor	EnumDesc
*SelectiveSuspend	Suspensión selectiva	0	Disabled
		1 (valor predeterminado)	habilitado

El controlador de minipuerto debe comprobar el valor de la palabra clave *SelectiveSuspend en el Registro antes de anunciar su compatibilidad con la suspensión selectiva de NDIS. Si la palabra clave *SelectiveSuspend tiene un valor de cero, el miniporte no debe anunciar la compatibilidad con ninguna funcionalidad de suspensión selectiva. Para obtener más información, vea Reporting NDIS Selective Suspend Capabilities.

*Palabra clave INF de SSIdleTimeout

El archivo INF para el controlador de minipuerto que admite la suspensión selectiva de NDIS debe especificar la palabra clave INF estandarizada *SSIdleTimeout opcional. Esta palabra clave especifica el período de tiempo de espera de inactividad en unidades de segundos. Si NDIS no detecta ninguna actividad en el adaptador de red durante un período que supere el valor *SSIdleTimeout , NDIS inicia una operación de suspensión selectiva llamando a la función de controlador MiniportIdleNotification del controlador de miniport.

Una vez instalado el controlador, los administradores pueden actualizar el valor de la palabra clave *SSIdleTimeout en la página de propiedades Avanzadas del adaptador de red. Para obtener más información sobre las propiedades avanzadas, vea Especificar parámetros de configuración para la página Propiedades avanzadas.

Nota El controlador de minipuerto se reinicia automáticamente después de realizar un cambio en la página de propiedades avanzadas del adaptador.

La palabra clave *SSIdleTimeout INF es una palabra clave numérica (Int). En la tabla siguiente se describen las posibles entradas INF para la palabra clave INF *SSIdleTimeout . Las columnas de la tabla describen los siguientes atributos para una palabra clave Int :

SubkeyName
Nombre de la palabra clave que debe especificar en el archivo INF. Este nombre también aparece en el Registro bajo la clave NDI\params\ del adaptador de red.

ParamDesc
Texto para mostrar asociado a SubkeyName.

Nota El proveedor de hardware independiente (IHV) puede definir cualquier texto descriptivo para SubkeyName.

Valor predeterminado
Valor predeterminado del entero.

Valor mínimo
Valor mínimo permitido para un entero.

Valor máximo
Valor máximo permitido para un entero.

SubkeyName	ParamDesc	Valor predeterminado	Valor mínimo	Valor máximo
*SSIdleTimeout	Tiempo de espera de inactividad de suspensión selectiva en unidades de segundos	5	1	60

Nota NDIS lee el valor de la palabra clave INF estandarizada *SSIdleTimeout para cada instancia del adaptador de red cuyo controlador admite la suspensión selectiva de NDIS. Los controladores de minipuerto no deben leer esta palabra clave.

NDIS mide el tiempo de espera de inactividad mediante temporizadores que son precisos en un 30 % del valor *SSIdleTimeout . Por ejemplo, si el valor *SSIdleTimeout es 10, el adaptador se suspende entre 10 y 13 segundos después de que NDIS detecte por primera vez que el adaptador está inactivo.

*Palabra clave SSIdleTimeoutScreenOff INF

El archivo INF del controlador de minipuerto que admite la suspensión selectiva de NDIS debe especificar la palabra clave OPCIONAL *SSIdleTimeoutScreenOff estandarizada INF. Esta palabra clave especifica el período de tiempo de espera de inactividad en unidades de segundos y solo es aplicable cuando la pantalla está desactivada. Si NDIS no detecta ninguna actividad en el adaptador de red durante un período que supere el valor *SSIdleTimeoutScreenOff después de que la pantalla esté desactivada, NDIS inicia una operación de suspensión selectiva mediante una llamada a la función del controlador MiniportIdleNotification del controlador de miniporte.

Una vez instalado el controlador, los administradores pueden actualizar el valor de la palabra clave *SSIdleTimeoutScreenOff en la página de propiedades Avanzadas del adaptador de red. Para obtener más información sobre las propiedades avanzadas, vea Especificar parámetros de configuración para la página Propiedades avanzadas.

Nota El controlador de minipuerto se reinicia automáticamente después de realizar un cambio en la página de propiedades avanzadas del adaptador.

La palabra clave *SSIdleTimeoutScreenOff INF es una palabra clave numérica (Int). En la tabla siguiente se describen las posibles entradas INF para la palabra clave *SSIdleTimeoutScreenOff INF. Las columnas de la tabla describen los siguientes atributos para una palabra clave Int :

SubkeyName
Nombre de la palabra clave que debe especificar en el archivo INF. Este nombre también aparece en el Registro bajo la clave NDI\params\ del adaptador de red.

ParamDesc
Texto para mostrar asociado a SubkeyName.

Nota El proveedor de hardware independiente (IHV) puede definir cualquier texto descriptivo para SubkeyName.

Valor predeterminado
Valor predeterminado del entero.

Valor mínimo
Valor mínimo permitido para un entero.

Valor máximo
Valor máximo permitido para un entero.

SubkeyName	ParamDesc	Valor predeterminado	Valor mínimo	Valor máximo
*SSIdleTimeoutScreenOff	Tiempo de espera de inactividad de suspensión selectiva en unidades de segundos	3	1	60

Nota NDIS lee el valor de la palabra clave INF estandarizada *SSIdleTimeoutScreenOff para cada instancia del adaptador de red cuyo controlador admite la suspensión selectiva de NDIS. Los controladores de minipuerto no deben leer esta palabra clave.

Nota El valor máximo es solo para fines de prueba. La prueba de certificación HLK comprobará explícitamente y producirá un error si el valor es superior a 5.

NDIS mide el tiempo de espera de inactividad mediante temporizadores que son precisos en un 30 % del valor *SSIdleTimeoutScreenOff . Por ejemplo, si el valor *SSIdleTimeoutScreenOff es 5, el adaptador se suspende entre 5 y 6,5 segundos después de que NDIS detecte primero que el adaptador está inactivo.