Palavras-chave INF padronizadas para suspensão seletiva do NDIS

Observação

As palavras-chave relacionadas à Suspensão Seletiva são apenas para uso de driver de miniporto NDIS tradicional. Eles foram preteridos na Extensão de Classe WDF do Adaptador de Rede (NetAdapterCx) e não devem ser usados por seus drivers cliente.

As seguintes palavras-chave INF padronizadas são definidas para habilitar, desabilitar e configurar parâmetros para suspensão seletiva do NDIS em um driver de miniporta:

*SelectiveSuspend Palavra-chave INF

*SSIdleTimeout Palavra-chave INF

*SSIdleTimeoutScreenOff Palavra-chave INF

Para obter mais informações sobre palavras-chave INF padronizadas, consulte Palavras-chave INF padronizadas para dispositivos de rede.

*Palavra-chave INF SelectiveSuspend

O arquivo INF para o driver de miniporto que dá suporte à suspensão seletiva do NDIS deve especificar a palavra-chave INF padronizada *SelectiveSuspend. Depois que o driver é instalado, os administradores podem atualizar o valor *SelectiveSuspend palavra-chave na página de propriedades Avançado para o adaptador de rede. Para obter mais informações sobre propriedades avançadas, consulte Especificando parâmetros de configuração para a página Propriedades Avançadas.

Nota O driver de miniporta é reiniciado automaticamente depois que uma alteração é feita na página de propriedades Avançado do adaptador.

O palavra-chave INF *SelectiveSuspend é uma palavra-chave de enumeração. A tabela a seguir descreve as possíveis entradas INF para o palavra-chave INF *SelectiveSuspend. As colunas nesta tabela descrevem os seguintes atributos para uma enumeração palavra-chave:

SubkeyName
O nome do palavra-chave que você deve especificar no arquivo INF. Esse nome também aparece no registro sob a chave NDI\params\ do adaptador de rede.

Paramdesc
O texto de exibição associado a SubkeyName.

Nota O IHV (fornecedor independente de hardware) pode definir qualquer texto descritivo para o SubkeyName.

Valor
O valor inteiro de enumeração associado a cada SubkeyName na lista.

EnumDesc
O texto de exibição associado a cada valor que aparece na página de propriedades Avançado .

SubkeyName	Paramdesc	Valor	EnumDesc
*SelectiveSuspend	Suspensão seletiva	0	Desabilitado
		1 (padrão)	habilitado

O driver de miniporta deve marcar o valor de palavra-chave *SelectiveSuspend no registro antes de anunciar seu suporte para a suspensão seletiva do NDIS. Se o palavra-chave *SelectiveSuspend tiver um valor igual a zero, o miniporto não deverá anunciar suporte para quaisquer recursos de suspensão seletiva. Para obter mais informações, consulte Relatórios de recursos de suspensão seletiva do NDIS.

*Palavra-chave INF SSIdleTimeout

O arquivo INF para o driver de miniporto que dá suporte à suspensão seletiva do NDIS deve especificar a palavra-chave INF padronizada *SSIdleTimeout opcional. Esse palavra-chave especifica o período de tempo limite ocioso em unidades de segundos. Se o NDIS não detectar nenhuma atividade no adaptador de rede por um período que exceda o valor *SSIdleTimeout , o NDIS iniciará uma operação de suspensão seletiva chamando a função do manipulador MiniportIdleNotification do driver de miniport.

Depois que o driver é instalado, os administradores podem atualizar o valor de *SSIdleTimeout palavra-chave na página de propriedades Avançado para o adaptador de rede. Para obter mais informações sobre propriedades avançadas, consulte Especificando parâmetros de configuração para a página Propriedades Avançadas.

Nota O driver de miniporta é reiniciado automaticamente depois que uma alteração é feita na página de propriedades avançadas do adaptador.

O palavra-chave INF *SSIdleTimeout é um palavra-chave numérico (Int). A tabela a seguir descreve as possíveis entradas INF para a palavra-chave INF *SSIdleTimeout. As colunas na tabela descrevem os seguintes atributos para um int palavra-chave:

SubkeyName
O nome do palavra-chave que você deve especificar no arquivo INF. Esse nome também aparece no registro sob a chave NDI\params\ do adaptador de rede.

Paramdesc
O texto de exibição associado a SubkeyName.

Nota O IHV (fornecedor independente de hardware) pode definir qualquer texto descritivo para o SubkeyName.

Valor padrão
O valor padrão para o inteiro.

Valor mínimo
O valor mínimo permitido para um inteiro.

Valor máximo
O valor máximo permitido para um inteiro.

SubkeyName	Paramdesc	Valor padrão	Valor mínimo	Valor máximo
*SSIdleTimeout	Suspensão seletiva do tempo limite ocioso em unidades de segundos	5	1	60

Nota O NDIS lê o valor do palavra-chave INF padronizado *SSIdleTimeout para cada instância do adaptador de rede cujo driver dá suporte à suspensão seletiva do NDIS. Os drivers de miniporta não devem ler esta palavra-chave.

O NDIS mede o tempo limite ocioso usando temporizadores precisos para dentro de 30% do valor *SSIdleTimeout . Por exemplo, se o valor *SSIdleTimeout for 10, o adaptador será suspenso entre 10 e 13 segundos depois que o NDIS detectar pela primeira vez que o adaptador está ocioso.

*Palavra-chave SSIdleTimeoutScreenOff INF

O arquivo INF para o driver de miniporto que dá suporte à suspensão seletiva do NDIS deve especificar a palavra-chave INF padronizada *SSIdleTimeoutScreenOff opcional. Esse palavra-chave especifica o período de tempo limite ocioso em unidades de segundos e só é aplicável quando a tela está desativada. Se o NDIS não detectar nenhuma atividade no adaptador de rede por um período que exceda o valor *SSIdleTimeoutScreenOff depois que a tela estiver desativada, o NDIS iniciará uma operação de suspensão seletiva chamando a função de manipulador MiniportIdleNotification do driver de miniport.

Depois que o driver é instalado, os administradores podem atualizar o valor de palavra-chave *SSIdleTimeoutScreenOff na página de propriedades Avançado para o adaptador de rede. Para obter mais informações sobre propriedades avançadas, consulte Especificando parâmetros de configuração para a página Propriedades Avançadas.

Nota O driver de miniporta é reiniciado automaticamente depois que uma alteração é feita na página de propriedades avançadas do adaptador.

O palavra-chave INF *SSIdleTimeoutScreenOff é um palavra-chave numérico (Int). A tabela a seguir descreve as possíveis entradas INF para a palavra-chave INF *SSIdleTimeoutScreenOff. As colunas na tabela descrevem os seguintes atributos para um int palavra-chave:

SubkeyName
O nome do palavra-chave que você deve especificar no arquivo INF. Esse nome também aparece no registro sob a chave NDI\params\ do adaptador de rede.

Paramdesc
O texto de exibição associado a SubkeyName.

Nota O IHV (fornecedor independente de hardware) pode definir qualquer texto descritivo para o SubkeyName.

Valor padrão
O valor padrão para o inteiro.

Valor mínimo
O valor mínimo permitido para um inteiro.

Valor máximo
O valor máximo permitido para um inteiro.

SubkeyName	Paramdesc	Valor padrão	Valor mínimo	Valor máximo
*SSIdleTimeoutScreenOff	Suspensão seletiva do tempo limite ocioso em unidades de segundos	3	1	60

Nota O NDIS lê o valor da palavra-chave INF padronizada *SSIdleTimeoutScreenOff para cada instância do adaptador de rede cujo driver dá suporte à suspensão seletiva do NDIS. Os drivers de miniporte não devem ler este palavra-chave.

Nota O valor máximo é apenas para fins de teste. O teste de certificação HLK marcar explicitamente e falhará se o valor for superior a 5.

O NDIS mede o tempo limite ocioso usando temporizadores precisos para dentro de 30% do valor *SSIdleTimeoutScreenOff . Por exemplo, se o valor *SSIdleTimeoutScreenOff for 5, o adaptador será suspenso entre 5 a 6,5 segundos após o NDIS detectar pela primeira vez que o adaptador está ocioso.