Partilhar via


Ativando e desativando a funcionalidade NDK

Para ativar ou desativar a funcionalidade NDK, o NDIS emite uma solicitação OID OID_NDK_SET_STATE. Um driver de miniporta compatível com NDK deve registar o suporte para este OID na sua função MiniportOidRequest.

Determinando se a funcionalidade NDK pode ser habilitada

A palavra-chave *NetworkDirect determina se a funcionalidade NDK do driver de miniporta pode ser habilitada.

Se esse valor de palavra-chave estiver definido como 1 ("Habilitado"), a funcionalidade NDK poderá ser habilitada.

Se estiver definido como 0 ("Desativado"), a funcionalidade NDK não poderá ser ativada.

Quando o driver de miniporta é instalado, seu arquivo INF define esse valor de palavra-chave como 1 ("Enabled") por padrão. Para obter mais informações, consulte Requisitos INF para NDKPI.

Depois que o driver de miniporta for instalado, os administradores poderão atualizar o valor da palavra-chave *NetworkDirect definindo um novo valor na página de propriedades Advanced para o adaptador. Para obter mais informações sobre propriedades avançadas, consulte Especificando parâmetros de configuração para a página Propriedades avançadas.

Observação O driver de miniporta é reiniciado automaticamente depois que uma alteração é feita na página de propriedades Advanced para o adaptador.

Quando ativar ou desativar a funcionalidade NDK

Essa alteração de estado pode ser desencadeada por uma solicitação OID OID_NDK_SET_STATE ou por um sucesso ou falha no próprio adaptador.

Ativando ou desativando a funcionalidade NDK

Para ativar ou desativar a sua funcionalidade NDK, o driver de miniporta deve enviar um evento NetEventNDKEnable ou NetEventNDKDisable Plug and Play (PnP) para o NDIS.

Para enviar o evento PnP, o driver de miniporta chama a função NdisMNetPnPEvent, definindo o membro NetPnPEvent da estrutura NET_PNP_EVENT_NOTIFICATION para a qual o parâmetro NetPnPEvent aponta da seguinte maneira:

  • NetEventNDKEnable se a funcionalidade NDK deve ser habilitada.

  • NetEventNDKDisable se a funcionalidade NDK deve ser desabilitada.

O evento NetEventNDKDisable PnP aciona o NDIS e os drivers de camada superior para fechar suas instâncias de NDK_ADAPTER abertas no adaptador onde a funcionalidade NDK está sendo desabilitada. O evento PnP permanecerá pendente até que todas as instâncias de NDK_ADAPTER abertas no adaptador sejam fechadas.

Network Direct Kernel Provider Interface (NDKPI)