Compartilhar via


Requisitos do INF para NDKPI

O arquivo INF para um driver de miniporto que dá suporte ao NDK (kernel direto de rede) deve atender aos requisitos a seguir.

Valor de intervalo superior do NDIS

O arquivo INF do driver de miniporto deve especificar um valor de intervalo superior NDIS de "ndis5" para que os componentes do Windows descubram e usem os adaptadores de miniporte compatíveis com NDK que são atendidos pelo driver. Esse valor é especificado da seguinte maneira:

HKR, Ndi\Interfaces, UpperRange, 0, "ndis5"

*NetworkDirect INF palavra-chave

O arquivo INF deve especificar o valor *NetworkDirect palavra-chave da seguinte maneira:

  • Depois que o driver for instalado, os administradores poderão atualizar o valor *NetworkDirect palavra-chave na página de propriedades Avançado do adaptador.

Observação: o driver de miniporto é reiniciado automaticamente depois que uma alteração é feita na página de propriedades Avançado do adaptador.

HKR, Ndi\Params\*NetworkDirect,        ParamDesc,  0, "NetworkDirect Functionality"
HKR, Ndi\Params\*NetworkDirect,        Type,       0, "enum"
HKR, Ndi\Params\*NetworkDirect,        Default,    0, "1"
HKR, Ndi\Params\*NetworkDirect\enum,   "0",        0, "Disabled"
HKR, Ndi\Params\*NetworkDirect\enum,   "1",        0, "Enabled"

*NetworkDirectTechnology INF palavra-chave

O arquivo INF deve especificar o valor de *NetworkDirectTechnology palavra-chave da seguinte maneira:

  • Depois que o driver for instalado, os administradores poderão atualizar o valor *NetworkDirectTechnology palavra-chave na página de propriedades Avançado do adaptador. As enumerações são mutuamente exclusivas, o que significa que a seleção de um valor NetworkDirectTechnology exclui todas as outras. Isso permite que a Plataforma defina um comportamento estrito do dispositivo.
  • Um dispositivo deve expressar apenas os transportes com suporte. Os valores de transporte são identificadores que são mapeados para o WDK NDK_RDMA_TECHNOLOGY. Uma redefinição dos identificadores é proibida.
  • O comportamento de dispositivos com vários transportes simultâneos é indefinido. O dispositivo deve especificar um tipo de transporte.

Observação: o driver de miniporto é reiniciado automaticamente depois que uma alteração é feita na página de propriedades Avançado do adaptador.

HKR, Ndi\Params\*NetworkDirectTechnology,        ParamDesc,  0,  "NetworkDirect Technology"
HKR, Ndi\Params\*NetworkDirectTechnology,        Default,    0,  "1"
HKR, Ndi\Params\*NetworkDirectTechnology,        Type,       0,  "enum"
HKR, Ndi\Params\*NetworkDirectTechnology\enum,   1,          0,  "iWARP"
HKR, Ndi\Params\*NetworkDirectTechnology\enum,   2,          0,  "InfiniBand"
HKR, Ndi\Params\*NetworkDirectTechnology\enum,   3,          0,  "RoCE"
HKR, Ndi\Params\*NetworkDirectTechnology\enum,   4,          0,  "RoCEv2"
HKR, Ndi\Params\*NetworkDirectTechnology,        Optional,   0,  "0"

*NetworkDirectRoCEFrameSize INF palavra-chave

O arquivo INF para um driver de miniporte que dá suporte a *NetworkDirectRoCEFrameSize deve atender aos seguintes requisitos:

  • O palavra-chave *NetworkDirectRoCEFrameSize especifica a unidade de transmissão máxima solicitada pelo administrador para comunicações NetworkDirect. Os adaptadores que dão suporte ao *NetworkDirect palavra-chave com RoCE ou RoCEv2 devem dar suporte adicional a esse palavra-chave.

  • Os valores aceitáveis do Registro para *NetworkDirectRoCEFrameSize são 256, 512, 1024, 2048 e 4096. O valor de 1024 é necessário.

  • O adaptador deve usar o maior tamanho com suporte para *NetworkDirectRoCEFrameSize que não exceda *JumboPacket.

  • Se o valor configurado de *NetworkDirectRoCEFrameSize for diferente do MTU do RoCE operacional (ativo), o driver deverá registrar um evento no log de eventos do sistema indicando MTU de RoCE operacional (ativo).

Observação: o driver de miniporte é reiniciado automaticamente depois que uma alteração é feita na página de propriedades Avançado para o adaptador, a menos que a alteração possa ser efetivada sem a reinicialização.

A tabela a seguir descreve a palavra-chave e os valores de *NetworkDirectRoCEFrameSize que podem ser editados. Os valores mínimo e máximo definem os limites necessários para valores com suporte. Um adaptador individual pode dar suporte a um valor mínimo mais baixo ou um valor máximo mais alto, mas deve dar suporte a pelo menos esses valores.

SubkeyName Paramdesc Type Valor padrão Mín Max
*NetworkDirectRoCEFrameSize Unidade de transmissão máxima direta de rede enum 1024 256 4096

Para obter mais informações sobre propriedades avançadas, consulte Especificando parâmetros de configuração para a página Propriedades Avançadas.

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

NDKPI (Network Direct Kernel Provider Interface)