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.